Scribus Wiki Contributor Manual: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
Line 30: Line 30:


==Protected pages==
==Protected pages==
Only those wiki users who are members of the administrators group can edit or otherwise manipulate the protected pages. If you are not in that group then please use the "Discussion" page (a.k.a Talk page) for that article to leave your comments and suggest improvements. We will grant administrative rights to regular contributors who have shown their skill and commitment to helping the community by improving the documentation in the wiki. If a problem is urgent please contact the Scribus Team members on irc or email the page author directly.


==Official pages==
==Official pages==

Revision as of 19:26, 22 December 2010


Page stub.png
This article is a stub. Somebody created it because they felt that it would fill an important role in the structure and content schema of the Scribus Wiki. It needs to be written as soon as possible. Please check the page's history if you would like to contact the person who created this article or start writing it yourself.

Where to start

This article is intended for those members of Scribus community who would like to contribute their efforts to helping other members of the community use Scribus effectively by providing helpful documentation. The roles of contributors, editors, and moderators are not clearly defined as the wiki is intended to be a living structure, growing and developing in the direction that helps all of us. Whatever role you would like to take at least at first, your initial step would be to send a request for an account. Once you receive your account data by email please log on and change your password if necessary. You are advised to get acquainted with the Mediawiki User's Guide. However, it is likely that the information within this article can be sufficient to get you started until you are ready for more advanced editing actions. A good starting point is the Help Needed category. Those pages that require urgent attention usually have examples of the formatting code you might want to learn and improving them would bring an immediate benefit to the community. You are also welcome to go to the Special Pages section and look through uncategorized, orphaned, unlinked, and otherwise abandoned pages that you could bring back into the main structure of the wiki. See the following sections for more details on how this wiki is structured, so you could get an idea of how you could help.

Please use the "Discussion" page for this article to voice your thoughts on its content.

Wiki Structure

It is advisable to keep the wiki structure as simple as possible to make sure that the readers can find the relevant information in as few steps as possible. When creating several paths to a particular document use Redirects. For an examples see the Debian and Ubuntu pages.

Templates

All templates that are used in this wiki are located in the Template Category. Please check this list before creating new templates. Use the templates to make the editing process more collaborative and efficient. For instance, Editorial Templates can be used at the top of pages to tag the pages for clarification, updates, or deletion.

Style guidelines

It is recommended to keep a neutral and uniform style of discourse. It is preferable not to switch between the first, second, and third person many times within the same article. Avoidance of colloquial words and phrases will help readers whose first language is not English. The sentences should be as short as possible.

Important precautions

  • Say no to orphaned pages: make yourself acquainted with the categorical structure of the wiki. Pages that are not categorized or not linked to other pages of the wiki are prime candidates for neglect. Make an effort to determine where the article you are writing or editing fits in the overall structure of the wiki and add the appropriate category or page links. [[Category:Category_Name|Displayed Name (optional)]] is the preferred way to place a page into a category. See the category tree on the left side for the full list of available categories.
  • Be nice to thy neighbour: don't start shouting matches or editing wars. If there is no consensus on how a particular documentation task could be completed then feel free to pursue an alternate route. The wiki has a lot of capacity and the categories can accommodate a lot of pages.
  • Preview before you save: a lot of people could be watching a page, so if you save an article without previewing and then have to redo your edits there could be many useless messages generated by the system that could have been avoided by a judicious use of the "Show preview" button.

Protected pages

Only those wiki users who are members of the administrators group can edit or otherwise manipulate the protected pages. If you are not in that group then please use the "Discussion" page (a.k.a Talk page) for that article to leave your comments and suggest improvements. We will grant administrative rights to regular contributors who have shown their skill and commitment to helping the community by improving the documentation in the wiki. If a problem is urgent please contact the Scribus Team members on irc or email the page author directly.

Official pages