home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / ietf / userdoc2 / userdoc2-minutes-93jul.txt < prev    next >
Text File  |  1993-09-21  |  5KB  |  114 lines
  1.  
  2. CURRENT_MEETING_REPORT_
  3.  
  4. Reported by Ellen Hoffman/Merit
  5.  
  6. Minutes of the User Documents Revisions Working Group (USERDOC2)
  7.  
  8.  
  9. Current Working Group Activities
  10.  
  11. The USERDOC2 Working Group has completed two FYI RFC efforts since the
  12. last IETF. The new FYIs are:
  13.  
  14.  
  15.    o FYI 19:  ``Introducing the Internet--A Short Bibliography of
  16.      Introductory Internetworking Readings for the Network Novice'' by
  17.      Ellen Hoffman and Lenore Jackson.
  18.  
  19.    o FYI 20:  ``What is the Internet?''  by Ed Krol and Ellen Hoffman.
  20.  
  21.  
  22. The on-line files associated with FYI 19 are archived in ``Introducing
  23. the Internet,'' along with newer materials that are of interest to
  24. beginning users.  These archives can be accessed by e-mail, FTP, Gopher,
  25. and WAIS, as well as dial-up for those lacking Internet connectivity.
  26. Four sites currently maintain copies of the archive, and volunteers were
  27. requested for other sites willing to duplicate the files.  For
  28. additional information on the archive, send an e-mail message to
  29. nis-info@merit.edu with the text, ``send access.guide'' in the body of
  30. the message.
  31.  
  32.  
  33. Open Forum on Documentation Activities
  34.  
  35. The discussion began with a presentation by Bert Stals.  He described
  36. the work of the User Documentation Task Force, a sub-group of the RARE
  37. Information Services and User Support Working Group (ISUS). Their goal
  38. is to produce documentation for end users on an introductory and
  39. intermediate level, without duplicating other efforts such as User-Doc.
  40. Their first project is a set of one-pagers, each on a separate
  41. applications topic (gopher, e-mail, WAIS, WWW, archie, file transfer,
  42. Mailbase).  Bert noted user support staff could use the text in their
  43. own documentation series (using their own house-style).  Alternatively,
  44. simple formatted versions of the pamphlet will be available for those
  45. who wish to use them directly in several formats, including ASCII text
  46. and WordPerfect files.  The working group maintains a mailing list for
  47. those interested.
  48.  
  49.  
  50.  
  51.  To join, send to:    mailbase@mailbase.ac.uk
  52.  with the text:       subscribe rare-userdoc your_firsname your_lastname
  53.  
  54.                                    1
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Bert also described a cooperative project with EARN to update the first
  61. edition of EARN's ``Guide to Network Resource Tools.''
  62.  
  63. Ellen Hoffman asked for comments regarding whether the IETF should get
  64. documentation translated into other languages.  The discussion raised
  65. several points, including concerns that introductory rather than
  66. technical information was the area most in need of translation as most
  67. technical people understand English.  David Sitman (EARNInfo Officer)
  68. said that in his experience people were unwilling to translate documents
  69. but were more comfortable creating their own.  He also suggested that
  70. documentation written in the US tended to be chatty which made it more
  71. difficult for non-native English speakers.  Issues were also raised
  72. about when documentation is effective and the amount of effort required
  73. to produce it.  Jill Foster noted that there are various levels of
  74. documentation, and that each has its own requirements.
  75.  
  76.  
  77. On-Going Projects
  78.  
  79. The next project is a revision of RFC 1175, the long bibliography.  The
  80. goal is to have a fairly complete draft by the next IETF. A revised
  81. charter will be posted (currently the file where the charter should be
  82. is empty---a situation the chairs will work on correcting after the
  83. meeting).  Ellen noted that she would like to include non-English
  84. introductory texts in the bibliography.  Suggestions for materials to
  85. include should be sent to her.
  86.  
  87.  
  88. Attendees
  89.  
  90. Jodi-Ann Chu             jodi@uhunix.uhcc.hawaii.edu
  91. Henry Clark              henryc@oar.net
  92. Klaus Fueller            klausf@osgo.ks.he.schule.de
  93. Ben Geerlings            ben.geerlings@surfnet.nl
  94. Ellen Hoffman            ellen@merit.edu
  95. Nandor Horvath           horvath@sztaki.hu
  96. Per Jacobsen             p.h.jacobsen@usit.uio.no
  97. Dennis Jennings          jennings@irlearn.ucd.ie
  98. Ola Johansson            ojn@tip.net
  99. April Marine             april@atlas.arc.nasa.gov
  100. Chuck McManis            chuck.mcmanis@eng.sun.com
  101. Pushpendra Mohta         pushp@cerf.net
  102. Lisa Nielsen             lisa@hawaii.edu
  103. Joyce K. Reynolds        jkrey@isi.edu
  104. Ulla Sandberg            ulla@kiera.ericsson.se
  105. Jennifer Sellers         sellers@nsipo.nasa.gov
  106. David Sitman             a79vm.tau.ac.il
  107. Patricia Smith           psmith@merit.edu
  108. Milan Sova               sova@feld.cvut.cz
  109. Bert Stals               bert.stals@surfnet.nl
  110. Marc van der Noordaa     noordaa@rare.nl
  111.  
  112.  
  113.                                    2
  114.