WikiGuide

Differences between revisions 1 and 6 (spanning 5 versions)
Revision 1 as of 2005-10-09 10:30:48
Size: 607
Editor: 81-178-213-108
Comment: created
Revision 6 as of 2005-10-17 14:49:17
Size: 3067
Editor: mailgate
Comment: added the beginnings of a guide to using the wiki
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Brainstorming page for some draft wiki rules to help posters and the DocumentationTeam make consistent, reliable wiki documentation. Add thoughts here: ## page was renamed from DraftWikiRules
{{{draft}}}
Line 3: Line 4:
 * always search for existing guides when inserting material
 * use the /forum page when adding material from the forum that is not fully formatted or has not been reviewed.
 * put pages into CategoryCleanup when they have not been reviewed.
 * don't link pages in UserDocumentation until they have been reviewed and are out of CategoryCleanup
 * when making any edits to pages, always leave a comment so others can see what you are doing easily.
This page contains some guidelines and help for how to post and work on the documentation in the Ubuntu wiki (UserDocumentation). Out aim is to make consistent, integrated and reliable documentation that users can access simply and quickly.

= Style and Guidelines =

Our aim is to make documentation which a new computer user can understand and which teaches the user what they are doing. With that in mind, please take into account the following guidelines:

 * Always search for existing guides when inserting material
 * Please read the [http://doc.ubuntu.com/styleguide/styleguide.html Documentation Team Styleguide] before posting.
 * When making any edits to pages, always leave a comment so others can see what you are doing easily.
 * Don't link pages in UserDocumentation until they have been reviewed and are out of CategoryCleanup
 * Use the ["forum"] page when adding material from the forum that is not fully formatted or has not been reviewed.
 * Put pages into CategoryCleanup when they have not been reviewed and be encouraged to discuss your contributions on the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-doc docteam mailing list]. If you let us know about it, it can be reviewed more quickly and taken out of CategoryCleanup.

= Help on Editing =

The wiki can often seem like a scary thing to start editing, but this is in fact NOT the case! It is easy to start editing and contribute. The best way to start is to look at the formatting which is employed on various pages (for example, you can see the code of this page [https://wiki.ubuntu.com/DraftWikiGuide?action=raw here].

The basic rules are:
 * Paragraphs should be separated by a blank line.
 * To make a list you use a white space at the beginning of a line, followed by either an asterisk (for bullet points), a number, letter etc.
 * To make a heading you use {{{= Title =}}} for a level one heading, {{{== Title ==}}} for a level 2 heading, and so on.
 * Placing {{{''}}} around words or phrases will make them italics, and {{{'''}}} will make them bold.
 * To quote a block of code, wrap paragraphs in {{{ {{{ }}} }}}.

An Example Page:

{{{
= Title of Page =
== Subtitle ==
This page is going to explain how to write a guide on the wiki. The following things are important:
 * Read the docteam Styleguide
 * Make sure you are not reproducing material already on the wiki
 * ask the Documentation Team to check the guide afterwards and place it in CategoryCleanup

The following paragraph is a lettered list:
 a. this is the ''first'' item
 a. this is the ''second'' item
 a. this is the ''third'' item
{{{
this is a block of code
} }} (the space should not be in your version)
}}}

It is that easy!

== Clever Things ==

As you edit the wiki you will learn how to use the power of the wiki software to do even more clever things! Here are some examples:
 * Inserting Icons (see IconsPage)
 * Inserting a table of contents (use {{{[[TableOfContents]]}}})
 * ''to add''

draft

This page contains some guidelines and help for how to post and work on the documentation in the Ubuntu wiki (UserDocumentation). Out aim is to make consistent, integrated and reliable documentation that users can access simply and quickly.

Style and Guidelines

Our aim is to make documentation which a new computer user can understand and which teaches the user what they are doing. With that in mind, please take into account the following guidelines:

Help on Editing

The wiki can often seem like a scary thing to start editing, but this is in fact NOT the case! It is easy to start editing and contribute. The best way to start is to look at the formatting which is employed on various pages (for example, you can see the code of this page [https://wiki.ubuntu.com/DraftWikiGuide?action=raw here].

The basic rules are:

  • Paragraphs should be separated by a blank line.
  • To make a list you use a white space at the beginning of a line, followed by either an asterisk (for bullet points), a number, letter etc.
  • To make a heading you use = Title = for a level one heading, == Title == for a level 2 heading, and so on.

  • Placing '' around words or phrases will make them italics, and ''' will make them bold.

  • To quote a block of code, wrap paragraphs in  {{{  }}}.

An Example Page:

= Title of Page =
== Subtitle ==
This page is going to explain how to write a guide on the wiki. The following things are important:
 * Read the docteam Styleguide
 * Make sure you are not reproducing material already on the wiki
 * ask the Documentation Team to check the guide afterwards and place it in CategoryCleanup

The following paragraph is a lettered list:
 a. this is the ''first'' item
 a. this is the ''second'' item
 a. this is the ''third'' item
{{{
this is a block of code
} }} (the space should not be in your version)

It is that easy!

Clever Things

As you edit the wiki you will learn how to use the power of the wiki software to do even more clever things! Here are some examples:

  • Inserting Icons (see IconsPage)

  • Inserting a table of contents (use [[TableOfContents]])

  • to add

WikiGuide (last edited 2008-08-06 16:40:22 by localhost)