Writing an Application Manual: Difference between revisions

From KDE Wiki Sandbox
No edit summary
Line 5: Line 5:
* Appname
* Appname
** Appname/Hints and Tips
** Appname/Hints and Tips
* Appname/Appname Manual # Your Contents page
* Appname/Manual # Your Contents page
** Appname/Appname Manual/An Introduction to Appname
** Appname/Manual/An Introduction to Appname
** Appname/Appname Manual/Configuration Choices
** Appname/Manual/Configuration Choices
** Appname/Appname Manual/The First Time you use Appname
** Appname/Manual/The First Time you use Appname
** Appname/Appname Manual/''section 1''
** Appname/Manual/''section 1''
** Appname/Appname Manual/''section xxx''
** Appname/Manual/''section xxx''
** Appname/Appname Manual/Hints and Tips
** Appname/Manual/Hints and Tips
** Appname/Appname Manual/Troubleshooting
** Appname/Manual/Troubleshooting
** Appname/Appname Manual/Found a bug?
** Appname/Manual/Found a bug?
** Appname/Appname Manual/Get involved #link to techbase etc
** Appname/Manual/Get involved #link to techbase etc


You will need a scratchpad to experiment with section headings/pages.  You can use either your UserTalk page, or the discussion pages attached to the area where you are working.  It's helpful if you remove anything no longer required, once the job is completed.
You will need a scratchpad to experiment with section headings/pages.  You can use either your UserTalk page, or the discussion pages attached to the area where you are working.  It's helpful if you remove anything no longer required, once the job is completed.

Revision as of 07:10, 25 August 2010

Notes

Manuals will be included as sub-pages of the main application page. For brevity, I will refer to that main page as Appname. The structure, therefore would be something like:

  • Appname
    • Appname/Hints and Tips
  • Appname/Manual # Your Contents page
    • Appname/Manual/An Introduction to Appname
    • Appname/Manual/Configuration Choices
    • Appname/Manual/The First Time you use Appname
    • Appname/Manual/section 1
    • Appname/Manual/section xxx
    • Appname/Manual/Hints and Tips
    • Appname/Manual/Troubleshooting
    • Appname/Manual/Found a bug?
    • Appname/Manual/Get involved #link to techbase etc

You will need a scratchpad to experiment with section headings/pages. You can use either your UserTalk page, or the discussion pages attached to the area where you are working. It's helpful if you remove anything no longer required, once the job is completed.

Contents

  • Once you have made the decisions (that can be a lengthy procedure), create appropriate links on the Contents page. It is, of course, possible to insert a section later if you find you've missed something.

Building your Manual

  • Use the red links to create the page, and write up a section at a time.
  • Note on the Discussion page anything you will need to refer to later, such as links that can't yet be created.

Preparing the Manual for Translation