[net.research] As Promised: Teacher's Manual for WRITEAID

awinterb@udenva.UUCP (Art Winterbauer) (05/06/85)

          WRITEAID                    -1-                      Teacher


                                WRITEAID MANUAL
                              _T_e_a_c_h_e_r'_s _S_u_p_p_l_e_m_e_n_t



          _N_O_T_E: You should be familiar with the operation of the  Wri-
          teaid  program  in the student mode before using the program
          in the teacher mode.

               This manual will help you to  alter  how  the  Writeaid
          program  works.   As  you  may know, the Writeaid program is
          designed to help students with their paper-planning  activi-
          ties.   The  program conducts an interview with the student.
          It begins by asking some questions which are meant to estab-
          lish  the  general  area in which the student wants to write
          the paper.  Then, in the second stage of  the  program,  the
          Writeaid program does two things:  it recursively interviews
          the student in increasing detail about  the  topic(s)  which
          were  sketched  out  in  the  first part of the program, and
          simultaneously it constructs  an  outline  of  the  topic(s)
          which  the student is allowed to examine and modify periodi-
          cally.  After the students have had a  good  start  in  this
          planning  process,  they are to have a paper-planning inter-
          view with you.  They may even bring along printouts  of  the
          tentative  outlines  constructed  by  the  Writeaid program;
          these printouts can be quite useful  to  you,  as  they  may
          reveal much about how the student wants to write the paper.

               The Writeaid program itself, however, may not interract
          with  students  the  way you want it to.  In fact, the three
          files that the  program  uses  for  "fuel"  were  originally
          designed  with the freshman in mind, and, more specifically,
          the freshman taking a Composition and Rhetoric course.   The
          questions  that  the  program asks the students, and the way
          the program scans the students'  responses  to  these  ques-
          tions,  may  seem  somewhat  simplistic  and  vague for more
          advanced students. Thus, there exists a "teacher's side"  to
          the  Writeaid  program,  which  allows you to create more of
          these "fuel" files for the program  to  use  in  interacting
          with students.

                                 _W_R_i_t_a: _A _S_t_o_r_y

               Imagine that the Writeaid program is a graduate student
          (we'll  call  her  WRita).  You hired WRita some time ago to
          help you work with your students' writing.  After you assign
          a  paper  to  your students, you encourage them to see WRita
          after they've thought about their topics for a day  or  two.
          WRita's  job  is to act as a "screening filter."  She covers
          the basic fundamentals of writing.  The students  brainstorm
          with  WRita, using her to narrow down their paper topics, to
          come up with some good ideas on what to write, and to make a
          first stab at organizing the basic structure of their paper.


          August 16, 1984







          WRITEAID                    -2-                      Teacher


          Then, WRita passes the students on  to  you  a  day  or  two
          later,  so  that  you  and the students can discuss the more
          technical details of content and the most  effective  format
          for the paper.

               So far, so good.  However, you teach a course  in  Sofa
          Ergometrics,  and  WRita  is  a  grad student in the English
          Department.  How is she to help your students,  who  princi-
          pally  write  research reports within the field of furniture
          Ergometrics?  The fact is, she can't, unless you provide her
          with some guidance.

               So, you move a 3-drawer  filing  cabinet  into  WRita's
          office.   Into  these file drawers you have placed some good
          questions and strategies  WRita  can  use  to  provide  more
          specific help for your students (WRita has heretofore relied
          almost exclusively on Aristotelian heuristics for  exploring
          topics, an approach which has left your students cold).  You
          instruct WRita to refer to these file drawers in the follow-
          ing manner.

               The top file drawer is called QST.  WRita is  to  refer
          to  this  drawer  first when working with a student.  In QST
          are a variety of "opening" questions she can use when  first
          exploring  possible topics with your students.  For example,
          any of the following questions would be appropriate:


           1. Why would a scholar of Sofa Ergometrics be interest-
              ed in <your topic>?

           2. How would you relate <your topic> to the history  of
              Sofa Ergometrics?

           3. How would you explain <your topic> to a  person  un-
              familiar with Sofa Ergometrics?



               You instruct WRita that all she has to do  when  asking
          these  questions  is  to  insert  the tentative title of the
          student's paper in the place of <your  topic>,  and  to  jot
          down  the  student's  responses to these questions for later
          reference.

               After WRita has asked all these questions, it  is  time
          for  her  to  help  the  student  to expand on what has been
          covered so far.  In the past, WRita would bring up  in  turn
          each  of  the  issues  raised during the initial questioning
          session, make  some  remark  about  the  student's  original
          response to these questions, and then listen attentively for
          certain clues that would reveal to her how well prepared the
          student was to pursue discussion of that issue.  Even if she


          August 16, 1984







          WRITEAID                    -3-                      Teacher


          wasn't quite prepared technically to follow  the  arguements
          advanced  by the student, she did recognize certain rhetori-
          cal patterns that told her if the student seemed to be  very
          sure  of a certain position ("because," "thus," "therefore,"
          "I know," "I really do think"),  very  uncertain  ("I'm  not
          sure,"  "I  think  that perhaps," "probably"), or maybe just
          lost ("I don't know," "have no  idea,"  "what's  going  on,"
          "confused").   Now,  you want WRita to be really sharp.  You
          recognize that her present listening skills  and  strategies
          are sound in themselves, but they're inadequate to help your
          students in Sofa Ergometrics.  Thus, you refer WRita to  the
          other  two  drawers in the filing cabinet: KEY and RND.  You
          instruct WRita to peruse the  contents  of  these  two  file
          drawers  and  to  become familiar with their contents.  Upon
          inspection, WRita discovers that KEY is a set of files  that
          consists  of key phrases or "triggers" with which she should
          become familiar.  In addition to her own, native-grown voca-
          bulary, these key phrases are like an additional glossary of
          Sofa Ergometrics jargon to which she should attune her  ear.
          She  also  finds  that you have even jotted down a couple of
          possible remarks she can make if she encounters any of these
          expressions in her conversations with your students.  And to
          save WRita any embarrassing  pauses  in  conversations  with
          students,  you have provided her with the RND file.  It con-
          tains some helpful "random" conversation starters and  fill-
          ers  she can use in dialogues with your students (especially
          when she doesn't have an opportunity to  use  the  materials
          from the KEY files).

               WRita uses KEY  and  RND  while  she  engages  in  more
          detailed  interviews  with  your  students.  As she conducts
          these interviews, she keeps notes of the  conversation,  and
          attempts  to  build outlines of the topics under discussion.
          She gives these outlines to the students  when  they  leave,
          but  she also tells them  that these are simply "trial" out-
          lines; any final plans  for  the  paper  shouldn't  be  made
          without  consulting  you,  the instructor.  These trial out-
          lines only serve the purpose of grist for the student's mill
          (food  for thought?), and that the student should critically
          examine these outlines that WRita has come up  with  on  the
          spur  of  the  moment.   WRita  has also found it helpful to
          encourage the student to pay her more than one visit  before
          coming  to  you;  in fact, WRita can have two or three half-
          hour conversations with each of  your  students  before  you
          even  see them.  WRita saves her notes from one interview to
          the next, and gives students copies of her notes as well.

               Insert the term Writeaid for WRita, and you have a good
          idea  of  how  the  program is designed to work.  Now, I can
          introduce the following "computer jargon" terms to you,  and
          they will hopefully make sense:




          August 16, 1984







          WRITEAID                    -4-                      Teacher


           1. file = one of the file drawers; in this  case,  QST,
              RND,  and  KEY.   If you don't like the way Writeaid
              currently counsels students, you can  move  in  your
              own  file  cabinet  (i.e., create your own files, OR
              simply modify what presently exist).
           2. parsing = look at the contents of a sentence for its
              meaning.   I don't use the term in its most rigorous
              (linguistic) sense.  When you  add  to,  or  modify,
              Writeaid's  abilities  to recognize certain patterns
              in students' responses (i.e., when  you  modify  the
              contents  of  the KEY file), you change the patterns
              that Writeaid is looking for.  Thus, you've  altered
              how  Writeaid parses students' sentences.  I'll talk
              more about this in a moment,  because  altering  the
              KEY  file  is  probably the more complicated process
              involved in working with Writeaid.


                                 _T_h_e _M_a_i_n _M_e_n_u



               When you type in the word _t_e_a_c_h_e_r,  you  will  see  the
          following Main Menu appear:


              1. Review a Question File

              2. Review a Random Response File

              3. Review a Keymatch File

              4. Make a Copy of a File for Modification

              5. Exit

              Please enter number of choice:



          These menu choices will now be discussed.


                      _M_A_I_N _M_E_N_U: _1. _R_e_v_i_e_w _a _Q_u_e_s_t_i_o_n _F_i_l_e

               This menu option allows you  to  do  several  different
          things.   You  can  1) look at a question file (remember the
          QST drawer that WRita used?), 2) create a new question file,
          and 3) modify a question file that already exists.

               To _l_o_o_k at a question file, you will have to  know  the
          name  of one.  For example, when you choose #1 above, Review
          a Question File, the computer will ask you:


          August 16, 1984







          WRITEAID                    -5-                      Teacher


                             What is the filename?

          That word "filename" is computer jargon for "file  name"  (I
          don't  know why we cram it together).  The computer needs to
          know the name of the file drawer,  in  other  words.   WRita
          used  one  called QST, but a file by that name may not be in
          the system.  If you know the name of  a  file  that  already
          exists,  type  it  in.   If  you don't, hang on a second and
          we'll create one.

               To _c_r_e_a_t_e a new question file, you can respond  in  the
          following way.  After you select #1 above (Review a Question
          File), and the computer comes back with:

                             What is the filename?

          just go ahead and make up a name and type it  in.   Just  be
          sure that the letters "qst" (for "question") are stuck some-
          where in the name.  This will help you  later  to  keep  all
          your  files  straight.   For example, the following question
          file names would be legit:


              johnqsthist
              englishqst2
              lfreudqstpm


          Just keep the name of the file of reasonable length and  the
          program  will  accept it (about 10 to 15 letters long).  The
          computer will then come back with another menu  of  all  the
          options  you have for playing with the question file.  We'll
          take a look at that in a moment.

               What happens if you call up the name of someone  else's
          file  (even accidently)?  Can't you mess it up?  Yes, that's
          a real possibility.  Although the computer usually  sets  up
          protection  routines to keep this thing from happening, I've
          had to disable them so  that  students  can  fully  use  the
          files.   So,  to _m_o_d_i_f_y a file that already exists (one that
          you didn't create in the first place), you  should  use  the
          4th  option  on  the  main  menu,  Make a Copy of a File for
          Modification.  Again, we'll talk about that later.

                               _Q_u_e_s_t_i_o_n _F_i_l_e _M_e_n_u

               Whenever you select #1 above, Review a  Question  File,
          and  enter  in the name of a file (even a brand new one that
          you're creating), you will receive another menu.  This is  a
          sub-menu that helps you to work with your question file--the
          Question File Menu.  It looks like this:




          August 16, 1984







          WRITEAID                    -6-                      Teacher


           Choose one:

           1. Enter records

           2. Delete records

           3. Examine records

           4. Freeze data and outttahere


          Let's look at these one at a time.

          _Q_u_e_s_t_i_o_n _F_i_l_e: _1. _E_n_t_e_r _R_e_c_o_r_d_s

               With this menu option, you can enter in  those  leading
          questions  (the ones WRita used to get the ball rolling with
          a student and to generate ideas about the paper).  With  the
          Writeaid program, however, you not only have to come up with
          a question, but _3 _v_e_r_s_i_o_n_s of the same question.  This is to
          keep  the  student from seeing the exact same question every
          time the program is used.  When you select "Enter  records,"
          the computer will come back with:


           Enter the three record versions

           1.


          This is your cue to enter in the first version of your ques-
          tion.   [If  you  type  in  a  long question, do _N_O_T hit the
          return key when you get to the right margin of  the  screen.
          Just keep typing and let the computer automatically jump you
          down to the next line.  When you've finished typing  in  the
          question, _t_h_e_n hit return.] Here is an example:

           1. How would you explain @ to a person unfamiliar  with
              the topic?


          Did you notice that "@"  in  the  middle  of  the  question?
          Whenever you type that into the body of a question, the com-
          puter will automatically embed  the  student's  topic  title
          into the question, to sort of personalize it.  So, if a stu-
          dent were to see this question on the screen, and his  topic
          was  "Sofa  Ergometrics  in  the Soviet Union," the computer
          would ask him:


              How would you explain Sofa Ergometrics in the Soviet
              Union to a person unfamiliar with the topic?



          August 16, 1984







          WRITEAID                    -7-                      Teacher


          Anyway, as soon as you press the <return key>  upon  comple-
          tion  of your first question version, the computer will come
          back with:


           2.


          This is your cue to enter in  the  second  version  of  your
          question, like:


           2. If someone didn't know anything about @,  how  would
              you explain it?


          When you press the return key, the machine will  prompt  you
          for the third version.  When you've finished entering in the
          third version, the question file menu will reappear.

               By the way, if you can't think of 3 versions of a ques-
          tion,  but only 2, then enter in one of the questions twice.
          Or, if you're really stuck, then enter in the same  question
          3  times!   The computer selects one group of questions only
          once (and from the group of 3, only 1 of the 3).   So,  even
          if  you  enter  in a question 3 times, the student will only
          see it once.

          _Q_u_e_s_t_i_o_n _F_i_l_e: _2. _D_e_l_e_t_e _r_e_c_o_r_d_s

               This option lets you delete a question _g_r_o_u_p that is in
          the  question  file.  Each group is numbered from 1 on.  You
          won't know what numbers are assigned to  each  group  unless
          you  use  the  third  option, "Examine records" (see below).
          When you select "Delete records,"  the  computer  will  come
          back with:


              Enter the record number to be deleted


          That's your cue to enter in the group number to be  deleted.
          That  question group will then be especially marked, so that
          when you exit this menu (with #4, Freeze data and outtahere,
          see  below), the question group you've selected for deletion
          will not be permanently saved.

          _Q_u_e_s_t_i_o_n _F_i_l_e: _3. _E_x_a_m_i_n_e _r_e_c_o_r_d_s

               This option lets you look at all the questions that are
          in  the question file. Each question group (a group = 3 ver-
          sions of the same question) will show a number  assigned  to
          it.  This is the "record number" of each group.


          August 16, 1984







          WRITEAID                    -8-                      Teacher


               The questions  may  scroll  across  the  screen  pretty
          quickly.   If  you  don't  have a button on your terminal to
          start and stop this scrolling, then use the  following  pro-
          cedure.  While holding down the <CTRL> key on your terminal,
          tap the "s" key.  Then release them both.   This  halts  the
          display.   To  restart the display, hold down the <CTRL> key
          again, and tap the "q" key.  To gain more control  over  the
          screen,  hold  down  the  <CTRL>  key  constantly,  and with
          another finger tap the "s" and "q" keys quickly, to pop for-
          ward a few lines at a time.

          _Q_u_e_s_t_i_o_n _F_i_l_e: _4. _F_r_e_e_z_e _d_a_t_a _a_n_d _o_u_t_t_a_h_e_r_e

               This option saves all the changes  you  may  have  made
          when entering and deleting records.  After number 4 has been
          pressed, you will again see the Main Menu.

               Should you change your mind about  saving  any  changes
          you  made, press down the <CTRL> key and with another finger
          tap the "C" key.  Then, type in "teacher" to  see  the  Main
          Menu again.

                  _M_A_I_N _M_E_N_U: _2. _R_e_v_i_e_w _a _R_a_n_d_o_m _R_e_s_p_o_n_s_e _F_i_l_e

               This option (chosen from the Main Menu) allows  you  to
          alter  the  random  response  files (i.e., the RND file that
          WRita was using).  The material in the Random Response  file
          is used by Writeaid when it cannot find anything specific to
          say to a given student remark.  If Writeaid can't find  any-
          thing useful in its Keyword File (discussed below), then the
          program draws a response from the Random  Response  file  to
          encourage   the  student  to  pursue  the  discussion.   The
          material in the Random Response file is a more sophisticated
          version  of  the "Uh huh, I see" that we use in conversation
          with one another.

               When this option is selected from the  Main  Menu,  the
          computer screen will display:


              What is the filename?


          You should then type in the name of the Random Response file
          you wish to review.  This procedure is identical to that for
          typing in the filename of a Question File.

                              _R_a_n_d_o_m _R_e_s_p_o_n_s_e _M_e_n_u

               After a filename has been entered, the  following  menu
          will appear:




          August 16, 1984







          WRITEAID                    -9-                      Teacher


              Choose one:

              1. Enter random expression

              2. Delete random expression

              3. Examine random expression

              4. Freeze data and outtahere


          _R_a_n_d_o_m _R_e_s_p_o_n_s_e _F_i_l_e: _1. _E_n_t_e_r _R_a_n_d_o_m _E_x_p_r_e_s_s_i_o_n

               Random expressions are entered one at a time, and  each
          one  is  assigned  a number upon entry.  When this option is
          chosen, the following prompt will appear:


              Enter the random expression


          You may now type in a sentence or question.   Some  examples
          are:


              I see, go on please.

              Why would you say that?

              Please give me more detail.


          After you've finished entering the expression, the  computer
          will show:


              Hit the return key now


          After you press the return key, you will be returned to  the
          Random Response File menu.

          _R_a_n_d_o_m _R_e_s_p_o_n_s_e _F_i_l_e: _2. _D_e_l_e_t_e _r_a_n_d_o_m _e_x_p_r_e_s_s_i_o_n

               This option allows you to delete random expressions  in
          the  Random  Response  file.   Each  expression has a number
          assigned to it.  When the Delete Random Expression option is
          chosen, the following prompt will appear on the screen:


              Enter record number to be deleted




          August 16, 1984







          WRITEAID                    -10-                     Teacher


          This is your cue to type in the number of the expression  to
          be  deleted (to find out expression numbers, use the Examine
          Random Expression option  discussed  below).   After  you've
          entered  the  number,  the  computer will come back with the
          following prompt:


              Hit the return key now


          This indicates that the expression to be  deleted  has  been
          especially  marked,  and when you exit the menu (Freeze Data
          and Outtahere), that expression will be permanently  deleted
          from the Random Expression File.

          _R_a_n_d_o_m _R_e_s_p_o_n_s_e _F_i_l_e: _3. _E_x_a_m_i_n_e _r_a_n_d_o_m _e_x_p_r_e_s_s_i_o_n

               This option operates similarly to  the  Examine  option
          for the Question file.  The numbered random expressions will
          flow past on the screen.  To control the flow of data  on  a
          CRT  terminal  screen,  use  <CTRL>  S and Q (see discussion
          under Review a Question File above).

          _R_a_n_d_o_m _R_e_s_p_o_n_s_e _F_i_l_e: _4. _F_r_e_e_z_e _d_a_t_a _a_n_d _o_u_t_t_a_h_e_r_e

               This  option  saves  all  modifications  to   permanent
          storage.   If  you have made modifications to the file which
          you would rather not save, then press <CTRL>  C  instead  of
          choosing   Freeze   Data  and  Outtahere,  and  then  retype
          "teacher" to retrieve the Main Menu  (see  discussion  under
          Review a Question File, Freeze Data and Outtahere, above).

                           _3. _R_e_v_i_e_w _a _K_e_y_m_a_t_c_h _F_i_l_e

               The Keymatch file is used by the Writeaid program  when
          it  scans  student responses.  Writeaid will examine student
          responses, looking for certain words,  parts  of  words,  or
          syntactical  patterns which have been stored in the Keymatch
          file.  When a match occurs, Writeaid will print one  of  the
          responses  which has been linked to that pattern.  For exam-
          ple, the word "thus" may be in the Keymatch file.  When Wri-
          teaid sees the word "thus" in the student's response to some
          question, the program will select one of the  two  responses
          linked  to the patterns "thus."  The program will respond to
          the student with either:


              You seem  to  be  coming  to  a  conclusion.   Am  I
              correct?

              or

              Please review for me the evidence which led  you  to


          August 16, 1984







          WRITEAID                    -11-                     Teacher


              this conclusion.


               You will have control over  the  key  expressions  that
          Writeaid  will  draw  upon, as well as what Writeaid says to
          the student when a key expression is encountered.  There are
          basically  two types of patterns: 1) literal patterns and 2)
          non-literal patterns.

          _l_i_t_e_r_a_l _p_a_t_t_e_r_n_s

               Literal patterns are words or parts of words.  The fol-
          lowing  are examples of literal patterns which can be placed
          in the Keymatch file:


              thus
               cause
              ing
              tion
              I am lost


          The word "thus" was entered with no spaces on either side of
          it.  This means that Writeaid will recognize the word "thus"
          if it is by itself and if it is  embedded  in  another  word
          (like  "thusly,"  "Malthus,"  etc.).  The word " cause " was
          entered with spaces on either side  of  it.   Writeaid  will
          only  recognize  "  cause  "  if  it  occurs  in a student's
          response with spaces on either side of it.   Thus,  Writeaid
          will only recognize " cause " if it stands alone as a single
          word, and will _N_O_T recognize it if  it  is  embedded  within
          other  words.   The  patterns  "ing" and "tion" were entered
          without spaces on either side of them.  Writeaid will recog-
          nize  them  if  they  are embedded within words (e.g., "run-
          ning," "organization").  The sentence "I am  lost"  will  be
          recognized  if it is found in the student's response exactly
          as it is shown here.  There will not be a match if the  stu-
          dent  types  in  some  variation of the sentence, like "I am
          really lost".

               To handle such variations, the  "non-literal"  function
          has been added.

          _n_o_n-_l_i_t_e_r_a_l _p_a_t_t_e_r_n_s

               This function will allow you  to  enter  keymatch  keys
          which  will  handle  student variations on the key patterns.
          There are 3 methods for handling  non-literal  patterns:  1)
          noise  patterns,  2)  any-order  patterns, and 3) mixture of
          noise and any-order.




          August 16, 1984







          WRITEAID                    -12-                     Teacher


               The _n_o_i_s_e pattern allows Writeaid to skip over unimpor-
          tant  words  (or "noise") in a student's response.  In order
          for Writeaid to effectively handle the example above ("I  am
          lost"),  you could enter the following key patterns into the
          Keymatch file:


              I*am*lost


          With this pattern, Writeaid would come up with  a  match  on
          the following student responses:


              I am totally lost.

              I really am totally lost.

              I must say that I believe I am  truly  confused  and
              lost.


          Writeaid will allow any words to be found where the *s  are.
          The only restriction is that the words "I", "am", and "lost"
          must be found in the order indicated.

               The _a_n_y-_o_r_d_e_r function  allows  Writeaid  to  scan  for
          words  or  patterns  in  whatever  order  they  occur in the
          student's response.  You will use the "/" character  to  act
          as a divider between these patterns.  If you wanted Writeaid
          to scan for the words "I am lost" in a  student's  response,
          but  without  regard  for the order in which they occur, you
          would enter in the following key pattern:


              I/am/lost


          Writeaid would then come up with a match  on  the  following
          student responses:


              It is lost I am.

              Sam and I are lost.


          (See if you can figure out why Writeaid would recognize that
          last sentence.)

               Last, there can be a _m_i_x_t_u_r_e  _o_f  _n_o_i_s_e  _a_n_d  _a_n_y-_o_r_d_e_r
          _p_a_t_t_e_r_n_s.   Although  the  sentence  "I  am  lost" is rather
          short,  I'll  use  it  as  an  example  for  the   sake   of


          August 16, 1984







          WRITEAID                    -13-                     Teacher


          consistency.  In actual practice, the "mixture" is more use-
          ful for interpreting  rather  lengthy  and  complex  student
          responses.

               If you wanted to scan for the words "I am" in the order
          indicated,  but allow for "noise" between the two words, and
          if you wanted the word "lost" to also be  recognized,  wher-
          ever  it  may  occur in a student's response, then you could
          enter the following key pattern:


              I*am/lost


          Writeaid  would  then  recognize   the   following   student
          responses:


              I am lost.

              It is lost that I think I am.

              In the event that Sam gets lost, call the police im-
              mediately.


          (That last one is tricky).  Of  course,  other  examples  of
          recognizable  student  variations are possible (I don't know
          how many).

               Before I go into detail about how you can use the  Key-
          match File program, there are two other items that should be
          mentioned: 1) level indicators and 2) "hits."

               The _l_e_v_e_l _i_n_d_i_c_a_t_o_r_s are displayed in the keymatch file
          right  next to each key pattern, and you are responsible for
          entering them.  A "level" is the level of  the  questioning,
          and you have the option of having Writeaid only look for key
          patterns at certain questioning  levels.   As  you  remember
          from using Writeaid in the student mode, each level of ques-
          tioning corresponds to the level or depth  of  the  outline.
          Thus, level 0 (zero) is the "least deep," and corresponds to
          the far-left margin in the student outline.  So, if you want
          the key pattern "thus" or some variation of "I am lost" only
          scanned at the top level of the interview process, then  you
          would  place a 0 (zero) next to that key pattern in the key-
          match file.  Similarly, if you want the pattern to  only  be
          scanned at level 1, 2, etc., then so indicate.  An interest-
          ing byproduct of this is the ability of having the same word
          (say  "thus")  scanned  at  different levels, with different
          responses coming back to the student from the keymatch file.
          For  example,  you  might believe that the student shouldn't
          reach conclusions too early in the  paper-planning  process,


          August 16, 1984







          WRITEAID                    -14-                     Teacher


          but you do want to encourage this activity at all other lev-
          els.  So, you enter the word "thus" as a key pattern, with a
          level indicator of 0, and compose a couple of responses that
          Writeaid can deliver to the student should the  word  "thus"
          be  encountered  at the top level.  Then, you enter the word
          "thus" again, with a level indicator of "@" (that  means  at
          all  levels),  with  responses  that question the conclusive
          statement.  The result of this would be:


           1. The student, at the highest level, enters  the  sen-
              tence: "I thus believe that so-and-so is true."  The
              machine would respond with both the 0  and  @  level
              remarks,  perhaps:  "Isn't  it  too  early  to start
              reaching for conclusions?  What support do you  have
              for this conclusion?"

           2. Later, the student at a deeper part of the interview
              enters  the  sentence: "And thus the medieval knight
              was a  mythical  invention  of  later  years."   The
              machine would then respond with only the @ level re-
              marks,  (assuming  it  randomly  chooses  the   same
              response  for "thus"): "What support do you have for
              this conclusion?"


               The _h_i_t indicator also appears next to the key  pattern
          in  the keymatch file, but you don't put that in.  It merely
          indicates which key patterns  have  been  found  in  student
          responses since the key patterns was entered.  If there is a
          "-" next to the key pattern, that means  that  Writeaid  has
          never  found that pattern in a student response.  However, a
          "&" next to the pattern indicates that it has  been  encoun-
          tered  in  a  student response.  This rather crude indicator
          should help you to determine which key patterns  are  useful
          and  which  are  not.  You may want to delete those key pat-
          terns which are never used.

               Now for the nuts and bolts about  entering  information
          into the keymatch file.  Remember that if you want to make a
          copy of someone else's keymatch file in order to  modify  it
          for  your own reasons, see the instructions later on in this
          manual under Make a Copy of a File for Modification.

                                 _K_e_y_m_a_t_c_h _M_e_n_u

               When you select the Review a Keymatch File option  from
          the Main Menu, the computer will respond with the prompt:


              What is the filename?




          August 16, 1984







          WRITEAID                    -15-                     Teacher


          This is your cue to type in the name of  the  Keymatch  file
          you wish to review.  After you've entered the name, the fol-
          lowing Keymatch menu will appear:


              Choose one:

              1. Enter keys

              2. Delete keys

              3. Examine keys

              4. Freeze data and outtahere


          As you can see, the Keymatch options look  very  similar  to
          those for the Random Response and Question files.

          _K_e_y_m_a_t_c_h _F_i_l_e: _1. _E_n_t_e_r _k_e_y_s

               When you choose this option, the program  will  provide
          the  prompts that you need to guide you through the entering
          of the proper  information.   The  first  prompt  that  will
          appear is:


              Enter the level of usage (0,1,2,...)
              [Type in @ for all levels]
              [Enter a period key to quit]
              level =


          This series of instructions allows you to enter in a  number
          to indicate the level for searching out key patterns in stu-
          dent responses, or to let you enter in the @ which  searches
          at all levels.  Should you decide to back out at this point,
          typing a period (".") key next to the "level =" prompt  will
          get you back to the Keymatch menu.

               After you've entered a number or the @ symbol to  indi-
          cate the level, the computer will respond with:


              Enter the keyword(s)
              1.


          This is your cue to enter the key pattern, using the * and /
          symbols as discussed previously.

               After you enter in the key pattern (end it with a  car-
          riage return), the computer will respond with:


          August 16, 1984







          WRITEAID                    -16-                     Teacher


              Enter the 2 response versions:
              1.


          Writeaid likes to have a choice of  what  to  say  after  it
          encounters  a key pattern in a student's response.  So, type
          in one sentence that it can respond with. (Remember  not  to
          hit  the  carriage return when you approach the right margin
          of the screen--just keep typing letters  until  you've  fin-
          ished the sentence and THEN hit the carriage return).

               After  you've  finished  the  first  version   of   the
          response, the machine will respond with:


              2.


          This means, type in the second version.  After  you've  done
          that, the machine will respond with:


              Enter the level of usage (0,1,2,...)
              [Type in a @ for all levels]
              level =


          If you don't want to enter a second key pattern, then  press
          the  "."  key and the Keymatch menu will return.  Otherwise,
          you can continue to enter key patterns as long as you want.

          _K_e_y_m_a_t_c_h _F_i_l_e: _2. _D_e_l_e_t_e _k_e_y_s

               The selection of this option  from  the  Keymatch  menu
          will  allow  you  to  delete  key patterns from the Keymatch
          File.  As with the Question and Random Response files, dele-
          tion is by number, which can only be ascertained after using
          the Examine Keys option (below).

               Key patterns will be marked for deletion and  will  not
          be  saved  once  you have executed option 4, Freeze Data and
          Outtahere.

          _K_e_y_m_a_t_c_h _F_i_l_e: _3. _E_x_a_m_i_n_e _k_e_y_s

               This option will list all  the  key  patterns  and  the
          responses associated with each pattern.  The format is:


              [Pattern #] [level of use]: [hit?] [key pattern]
              [Response version 1]
              [Response version 2]



          August 16, 1984







          WRITEAID                    -17-                     Teacher


              Where:
                      [Pattern #] = number of keypatterns  in  the
              file
                      [level of use] = @,1,2,....
                      [hit?] = & (this keypattern has  been  found
              in a student's response,
                               - (this  keypattern  has  NOT  been
              found in a student's response)
                      [key pattern] = the pattern being looked for
              in  the  student's  responses and which incorporates
              the patterns:
                           * (skip noise letters)
                           / (any-order divider)


          For examples:


              Pattern #   level  hit?  key pattern
              ---------   -----  ----  -----------
                      :   /      /       /
                      :  / ------  ------
                      :  : :      /
                      1. @:& I*lost
              Are you having troubles with the computer?
              I need more information in order to assist you.

              2. 1:- trouble/with/topic
              That could actually be a good sign this early in the
              game.
              You might be coming up with more ideas than you ori-
              ginally thought you could.


          Again, as with viewing  the  Question  and  Random  Response
          files,  you  may  find  it helpful to use the <CTRL> S and Q
          keys to stop and start the scrolling of  information  across
          the screen.

          _K_e_y_m_a_t_c_h _F_i_l_e: _4. _F_r_e_e_z_e _d_a_t_a _a_n_d _o_u_t_t_a_h_e_r_e

               This option saves all changes permanently  to  off-line
          storage  (the big disk).  It operates the same as the Freeze
          options for the Question and Random Response files.

              _M_A_I_N _M_E_N_U: _4. _M_a_k_e _a _c_o_p_y _o_f _a _f_i_l_e _f_o_r _m_o_d_i_f_i_c_a_t_i_o_n

               This option on the Main Menu  is  very  important.   It
          allows  you to make copies of other teachers' Question, Key-
          match, and Random Response files so that you can modify them
          for  your  own uses.  You will choose the name of your copy,
          and you can have your students use  it.   With  this  "copy"
          option,  you  won't  have  to make your own files completely


          August 16, 1984







          WRITEAID                    -18-                     Teacher


          from scratch, but can build upon the work of others.

               How do you find out the name of other teachers'  files?
          Simple.   Just  ask  me via electronic mail (send queries to
          awinterb).  I'll put  you  on  a  mailing  list  which  will
          periodically  circulate  the  names of other teachers' files
          (once they've finished their mods  and  with  their  permis-
          sion).   Then you can inspect the files and determine if you
          want to make a copy for your own purposes.

               When this option is selected, the computer will respond
          with:


              What is the filename of the file you want to copy?


          Type in the name of the file that you want a copy  of.   The
          machine will come back with:


              And what is the new name you want to give this copy?


          Give your copy a distinct name (that you  can  remember  and
          which  embodies the function of the file--qst, rnd, or key).
          The computer will check your request to make sure  the  name
          you've  selected  doesn't  clash  with  the name of somebody
          else's file, and then will make the copy.

               After that, all you have to do to modify  the  file  is
          call it up by the new name.

                                    _5. _E_x_i_t

               When you select this option, you  will  exit  the  Main
          Menu, and will be returned to regular computer operation.


                         _Y_o_u_r _I_n_s_t_r_u_c_t_i_o_n_s _t_o _S_t_u_d_e_n_t_s

               Whenever you create new files or rename  old  ones  for
          modification,  you  need  to  pass this information along to
          your students.  These new filenames are the  "secret  words"
          they use to initialize the Writeaid program.

               Most importantly, you must tell  them  the  _o_r_d_e_r  that
          they  are  to  enter  these words.  The first secret word is
          created by the students themselves,  and  is  usually  their
          "username"  logon code (but _n_o_t their password!).  The other
          3 secret words are the filenames for  the  question,  random
          response,  and  keymatch  files.  The order for all 4 secret
          words is:


          August 16, 1984







          WRITEAID                    -19-                     Teacher


              1. <student username>
              2. question filename
              3. random response filename
              4. keymatch filename


          For example, for the students to use the files I've created,
          they must type in:


              1. <student username>
              2. artqst1
              3. artrnd1
              4. artkey1


          Should you only modify, say, artrnd1, and give it  the  name
          "joernd," then "joernd" must be the 3rd secret word, and the
          rest would stay the same:


              1. <student username>
              2. artqst1
              3. joernd
              4. artkey1


               The information that the students need in order to  use
          Writeaid  is in their Writeaid student manuals.  Should they
          have questions about _W_r_i_t_e_a_i_d _p_r_o_g_r_a_m _b_e_h_a_v_i_o_r, tell them to
          get  in touch with me.  Should they have questions about _t_h_e
          _q_u_e_s_t_i_o_n_s _t_h_e _m_a_c_h_i_n_e _a_s_k_s _a_n_d _h_o_w  _i_t  _q_u_e_r_i_e_s  _t_h_e_m,  then
          refer  them  to  me  if they are using my files.  If they're
          using _y_o_u_r files, then it's up to you!





















          August 16, 1984










          Introduction ..........................................    1
          WRita: A Story ........................................    1
          The Main Menu .........................................    4
          MAIN MENU: 1. Review a Question File ..................    4
                  The Question File Menu ........................    5
                       1. Enter Records .........................    6
                       2. Delete Records ........................    7
                       3. Examine Records .......................    7
                       4. Freeze Data and Outtahere .............    8
          MAIN MENU: 2. Review a Random Response File ...........    8
               Random Response Menu .............................    8
                       1. Enter Random Expression ...............    9
                       2. Delete Random Expression ..............    9
                       3. Examine Random Expression .............   10
                       4. Freeze Data and Outtahere .............   10
          MAIN MENU: 3. Review a Keymatch File ..................   10
               Keymatch Menu ....................................   14
                       1. Enter Keys ............................   15
                       2. Delete Keys ...........................   16
                       3. Examine Keys ..........................   16
                       4. Freeze Data and Outtahere .............   17
          MAIN MENU: 4. Make a Copy of a File for Modification
               ..................................................   17
          MAIN MENU: 5. Exit ....................................   18
          Your Instructions to Students .........................   18


































-- 



"What are all these toads doing so far from the marsh?"
                                        Lautreamont

        Art Winterbauer  ucbvax!nbires-----------\
        DRI/Elect.       seismo!hao---------------\
        PO Box 10127     cires---------------------\
        Univ. of Denver  boulder--------------------\---> !udenva!awinterb
        Denver, CO  80210  (303)-871-2412