[wplug] Writing Tech Manuals

Gentgeen gentgeen at linuxmail.org
Sat Jun 24 10:47:34 EDT 2006


Dear List,

For the next school year, I know that part of my job description will
include writing "tech manuals" (for lack of a better word).  These
manuals will cover a number of issues that we see in our school (an
on line virtual school).  Some will be for the parents, some for the
staff, and some for the students.  These "manuals" will probably be
pretty short, kind of like the Linux mini-howtos.

I am currently thinking that I would like to do them with LaTeX (maybe
via LyX) so that I can create HTML, PDF, etc all from the same source. 
If I recall properly, there is even something like CSS for LaTeX, so I
could easily make all the files similar in appearance.  I am also
thinking that with LaTeX I will be able to use CVS type software to help
keep track of the changes.  Since I am not very familiar with either, I
need to get an early start so that by the time they tell me what topics
to work on, I will be ready.

I am wondering about anyone else's experience/thoughts.  LaTeX a good
way to go?  CVS a good way to go?  Would OpenOffice and stylesheets be a
better way?  Would OpenOffice work nice with CVS?  And what ever else
anyone might think of since this would be a new realm for me.

Kevin 



-- 
http://gentgeen.homelinux.org

#############################################################
 Associate yourself with men of good quality if you esteem    
 your own reputation; for 'tis better to be alone then in bad 
 company.        - George Washington, Rules of Civility


More information about the wplug mailing list