For most applications, a structure something like this would be appropriate:
Introduction: A basic description of what the application does and any noteworthy features, etc..
Using KApp
: Task-based description of
the most common uses of the application.
Program reference: Description of all of the features of the application. This would usually include a menu reference, but might also include command line options, syntax description, etc., if they are appropriate to the application.
This is required for all TDE applications that you at a minimum cover any application specific menu entries, and strongly recommended that you cover all the standard ones too (in case users are reading the manual outside of TDE, or yours happens to be the first one they read, and it provides consistency. Cut and paste is your friend here.)
Note that although this is a required section, and for some applications it is the only section, it should be considered a minimum.
Frequently Asked Questions: List the most common questions and problems that users have with the application, and their solutions. “How do I ...?”-type questions are especially appropriate.
Credits and License: A list of those who contributed to the documentation, and a link to the GNU Free Documentation License, under which all TDE documentation is licensed.
This chapter is required for all TDE documents, and must have at least the two license links (one for the document, and one for the application)
Installation: This chapter can be automatically generated, provided that the application follows the usual TDE compilation procedure (that is, ./configure, make && make install). If you need to add extra information about compiling or installing the application, it can go here.
You will find a template document with these sections in
trunk/KDE/kdelibs/kdoctools/template.docbook
file in TDE
Subversion repository.
Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team