c*****t 发帖数: 1879 | 1 My supervisor suggested me to document the project. I was thinking besides
javadoc the codes, it might be a good time to write some help files. Any
good (and free) tools, MS Office templates, etc that allow such that?
Any good help display system? (JavaHelp seems a bit complicated though,
any lightweight and free system?) The big boss is very frugal even though
he rich.
Thanks | e***g 发帖数: 158 | 2 there is this thing called 'docbook'... but it scares me. I just use Word.
【在 c*****t 的大作中提到】 : My supervisor suggested me to document the project. I was thinking besides : javadoc the codes, it might be a good time to write some help files. Any : good (and free) tools, MS Office templates, etc that allow such that? : Any good help display system? (JavaHelp seems a bit complicated though, : any lightweight and free system?) The big boss is very frugal even though : he rich. : Thanks
| c*****t 发帖数: 1879 | 3 It's scary to me as well. I definite do not want to write pages of document
in text mode. It's just not eye-pleasing.
【在 e***g 的大作中提到】 : there is this thing called 'docbook'... but it scares me. I just use Word.
| m**c 发帖数: 90 | 4
docbook is standard document format used in open-source community. For
example, JBOSS's document was written in docbook format. You can use either
SGML or XML to write docbook. The most important concept of using docbook is
that you only need to concerntrate on the CONTENT rather than CONTENT AND
FORMAT. Once you have docbook, you can format it into PDF, RTF, HTML, etc.
It is very useful if a group technical writers working on the same project
(ie. JBOSS), everyone just write his/her sectio
【在 c*****t 的大作中提到】 : It's scary to me as well. I definite do not want to write pages of document : in text mode. It's just not eye-pleasing.
|
|