home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 301.lha / hyperhelp / help / tips < prev    next >
Encoding:
Text File  |  1980-12-03  |  1.2 KB  |  38 lines
  1. (@title Style Considerations@)
  2. Simply pulling text from a manual and throwing it on the screen is not
  3. sufficient for creating effective on-line documentation.  You have a
  4. completely different medium to deal with, one that has its drawbacks as
  5. well as its advantages.
  6.  
  7.  
  8.  
  9. A complete text on what's good and bad for on-line documentation would fill
  10. a book (it has actually filled several).  If you're interested in learning
  11. more, a good starting point is the book "Documentation Style:  From Paper
  12. to On-line" by John R. Brockman.
  13.  
  14.  
  15.  
  16. Fortunately, there are only a few important things to remember for creating
  17. on-line documentation.  Since screen fonts are generally harder to read
  18. than text on paper, most of these points have to do with minimizing the
  19. amount of text presented at one time.
  20.  
  21.  
  22.  
  23. - Try to limit the number of ideas or concepts to one per screen.
  24.  
  25.  
  26.  
  27. - Keep the help windows away from the edges of the screen as much as
  28. possible.  CRT screens tend to lose focus at the edges; the reader has to
  29. work harder to read text along the edges.  Use the window-positioning
  30. environment variables to do this (the user might change these, but that's
  31. his choice -- you do what you can).
  32.  
  33.  
  34.  
  35. - Use a larger font size, if it's available.  Topaz 9 is much easier to
  36. read than Topaz 8.
  37.  
  38.