home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / lyx-0.13.2.tar.gz / lyx-0.13.2.tar / lyx-0.13.2 / lib / doc / README.Documentation < prev    next >
Text File  |  1998-04-23  |  1KB  |  41 lines
  1. README.Documentation
  2.  
  3. by John Weiss [5/97] weissjp@colorado.edu
  4.  
  5.  
  6. ================
  7. Introduction
  8.  
  9.     The purpose of this file is, primarily, to provide a style sheet
  10.     and helpful hints to those wishing to help with the documentation
  11.     project.  If you're actually looking for documentation, there are
  12.     6 files in LyX format which you can read from within LyX.  Check
  13.     out the Help menu to load Intro.lyx.  It's a good place to start.
  14.  
  15. ================
  16. Why a separate documentation project?  Can't the developers do it?
  17.  
  18.     In a word, no.  They're too busy adding features and squishing
  19.     bugs.
  20.  
  21.     Also, g++ is far more forgiving of style changes than a human
  22.     brain.  As long as the code is correct, g++ will happilly compile
  23.     it, and compile it the same way from machine to machine.  Human
  24.     brains are far less forgiving and far more individualized.  So,
  25.     the documentation needs to all be in a uniform style, in addition
  26.     to being grammatically correct and easily readable.  That's a
  27.     pretty big undertaking - which is why I volunteered to
  28.     administrate the docs in the first place!  Lars has enough to do
  29.     maintaining the code, anyways!
  30.  
  31. ================
  32. Helping Out
  33.  
  34.     If you'd like to contribute to the Documentation Project, please
  35.     read the file Intro.lyx.  It now contains all of the information
  36.     you'll need to get started.
  37.  
  38.  
  39. John Weiss
  40. 5/97
  41.