Wiki Editing and Style Guidelines

From Tizen Wiki
Jump to: navigation, search

Community Guidelines

Please also review our Community Guidelines and our Wiki Guidelines documents for additional guidelines and consequences associated with violating any of our guidelines.

The Wiki is Public

Everything in the wiki is public.

  • Every edit and every new page created goes into the recent changes feed, which means that people will see your edits, even if you haven't yet linked to a page.
  • Once it's out there, it's public. The wiki content may be mirrored, has feeds and is in the Google cache, so deleting something doesn't make it go away.
  • When you delete content from a page, the original content will still remain in the history for that page.

Collaborative Process

Creating articles in the wiki is a collaborative process. After you have written your piece, others may:

  • Edit
  • Alter
  • Adapt
  • Add

So don't worry about making your article perfect the first time through. Don't hesitate to add content you think is useful and don't hesitate to make edits where you think you can help. There's always somebody to fix anything that breaks.

Style

  • Keep your writing informative and not too casual, not too formal.
  • Avoid using technical language gratuitously. Explain or define terms which might reasonably be unknown to a reader.
  • If you need to use acronyms, explain them with the first use.
  • Page names should be short and to the point.
    • The page name is a label, not a sentence.
    • Use spaces. NoCamelCase (that is, use "Root access" instead of "RootAccess").
    • Use sentence capitalization for page titles. Only proper nouns should be capitalized after the first word (for example, Contributing to Tizen is OK, Contributing To The Wiki is not).
    • When using sub-pages, make sure that you are really grouping several related pages under a common root. Deep hierarchies make for long names. As a general rule, use no more than two levels for subpages (for example, Community Office/Meetings is OK, Community Office/Meetings/Meeting minutes from May 11 is not).
    • This article on URL design explains some of the principles behind good URL names - and every wiki page name is also a URL.

For more information, see the Wikipedia Style Guide.

Using the Wiki (How-to)

Where to start

Before creating a new page, you should first make sure that a page on your topic does not already exist:

  1. In the search box in the upper right corner, enter your topic.
  2. If the exact topic exists, the page will open.
  3. If there are related pages, you will get a search results page. Check if your topic is in the results.
  4. If your topic does not exist, choose create this page.

How to edit a page

If you'd like to change a page.

  1. Make sure that you are logged in to the wiki with your tizen.org username.
  2. Click the Edit tab.
  3. Enter your changes in the box.
  4. In the Summary box, enter a short explanation of what you did.
  5. Click Show preview if you want to check your changes.
  6. Click Save page.

Creating a subpage

Many sections in the wiki are organized by subtopic. There has been some confusion about how to create subpages, so here are the instructions:

  • Make sure you are logged in (and see instructions above for searching before you create a new page).
  • In the search box, type Community Office/My new page name.
  • Click "Go".

Note: To avoid creating orphan pages (that is, wiki pages that no other wiki page links to), it is recommended that you create a page by linking to it first, and then clicking on the link to the non-existent page. For example, Quality/My new page name. Also note that creating subpages more than 2 deep is advised against, since it makes link names longer, and does not help with the maintenance of the wiki. See the Style section above for the very brief style guide to the wiki.

Formatting

We use MediaWiki formatting (the same as used on Wikipedia, for example). For simple formatting, use the buttons above the edit box. For more information see:

Editing conventions on talk pages

Having discussions on a free-form wiki page will seem strange at first. It helps if everyone follows some simple editing conventions:

  • Always sign your name after your comments. Use the four tildes “~~~~” wiki syntax (or the signature button in the toolbar above the editing textbox).
  • Start a new discussion with a ==level 2 heading== at the bottom of the page.
  • Indent replies with colons (:) at the beginning of the line.

Credit

Based on Maemo wiki contribution guidelines and the MeeGo guidelines.