Tasks and Tools: Difference between revisions

From KDE UserBase Wiki
(→‎Ways to Contribute: correct typo)
Line 26: Line 26:
* [[How_To_Convert_a_UserBase_Manual_to_Docbook|How To Convert UserBase Manual to Docbook]] gives you an insight into the process that takes place on your finished manual.
* [[How_To_Convert_a_UserBase_Manual_to_Docbook|How To Convert UserBase Manual to Docbook]] gives you an insight into the process that takes place on your finished manual.


{{Info|1=It's important to be consistent, so here are some general rules:
{{Remember|1=It's important to be consistent, so here are some general rules:
* Take care with heading levels - we start at second level (Mediawiki uses top level for page-name), using <nowiki>"=="</nowiki>
* Take care with heading levels - we start at second level (Mediawiki uses top level for page-name), using <nowiki>"=="</nowiki>
* Make sure you refer frequently to this page and to [[Typographical_Guidelines|typographical guidelines]]
* Make sure you refer frequently to this page and to [[Typographical_Guidelines|typographical guidelines]]

Revision as of 17:51, 5 March 2011

Before you Start

First Things First

  • You must be a registered user to contribute. The Quick Start page tells you how to register and log in.
  • Be aware that your contribution will be governed by the licenses Gnu Free Document Licence and Creative Commons. Click on the images in the Navigation Panel to read the details.
  • Use the Talk page to communicate with other contributors or get help.

Relevance

It should relate to KDE software, directly or indirectly. We define it like this:

For New Users - helping to get started
For Regular Users - learning about changes
For Advanced Users - but use sub-pages for this.
For Developers - Techbase is the place for that

Ways to Contribute

Remember

It's important to be consistent, so here are some general rules:
  • Take care with heading levels - we start at second level (Mediawiki uses top level for page-name), using "=="
  • Make sure you refer frequently to this page and to typographical guidelines
  • * Check if all table cells have space after the pipe character. This rule conforms with traditional wiki formatting.
  • Make application name formatting consistent (avoid using Amaroks, do use Amarok's).
  • Ensure that all images are in PNG format (you can use JPEG (.jpeg, not .jpg) as well, but in this case you should convert your images to PNG later. Save work by converting them before you start .
  • Remove all non-printable characters from image names.


Hints and Tips

Some Preferences that will help -

  • If you don't have [edit] links against the sections, open your User Preferences (Personal Tools in the sidebar) then look for Editing and set Enable section editing via [edit] links
  • While you are in those settings, enable Show preview on first edit - while you are editing you can glance at the original display for reference
  • The default display is to show the preview first, with the edit box below. If you prefer the edit box at the top you can change that setting in the same place