THE SPDX WIKI IS NO LONGER ACTIVE. ALL CONTENT HAS BEEN MOVED TO https://github.com/spdx

Difference between revisions of "Wiki Conventions"

From SPDX Wiki
Jump to: navigation, search
(Convert to MediaWiki syntax)
(Add wiki conventions for our new MediaWiki wiki)
Line 1: Line 1:
Here are some instructions for using the SPDX wiki. Every user who is logged into spdx.org can modify wiki pages. At the top of a page, you'll see an "Edit" option. You can then edit the page using the HTML editor. When you save the page, make sure to put in a message in "Log message" briefly explaining the change you've made. Then click on "Save" at the bottom of the page to save or on "Preview" or "Preview changes" to preview before saving.
+
This page describes conventions that should be followed on the SPDX wiki. You can also read the page on [[Getting started|getting started]].
  
If a page has been edited more than once, you'll see a "Revisions" link at the top of the page (next to "Edit"). Clicking on this link will allow you to see in detail which changes have been made to the page.
+
== SubPages ==
  
If you want to create a new page, click on "Add child page".
+
This wiki uses subpages to provide a hierarchy. For example, the minutes for the business team are located under <code>Business Team/Minutes</code>.
  
If you want to add a visible comment, please start the comment by indicating the source by your initials, bolded, surrounded by angle brackets. Then put the comment itself in italics. For example: '''&lt;kes&gt;''' ''this is a comment or a question?.'' The purpose of this is to make sure its clear that this is not part of the official text of the standard at this point, and provides localized context for the discussion.
+
When you add a new page, please make sure to use the correct hierarchy.  If you want to create a new business related page, choose <code>Business Team/name of page</code> If you'd like to add new business minutes, add them as <code>Business Team/Minutes/YYYY-MM-DD</code>
 +
 
 +
== Categories ==
 +
 
 +
We use categories to organize pages. You should add one of these categories at the bottom of each new page:
 +
* <nowiki>[[Category:Business]]</nowiki>
 +
* <nowiki>[[Category:General]]</nowiki>
 +
* <nowiki>[[Category:Legal]]</nowiki>
 +
* <nowiki>[[Category:Technical]]</nowiki>
 +
 
 +
== Adding minutes ==
 +
 
 +
The list of minutes is updated automatically but this requires minutes to be added in the right location.  Please use <code>XXX Team/Minutes/YYYY-MM-DD</code> for new minutes.
 +
 
 +
Additionally, minutes should have the category <nowiki>[[Category:Minutes]]</nowiki> in addition to the category defining the subject area.
 +
 
 +
== Headings ==
 +
 
 +
Make sure not to use a heading starting with <nowiki>=</nowiki> as this reserved for the title of the page. Headings should start with <nowiki>==</nowiki>.  See the [http://www.mediawiki.org/wiki/Help:Formatting MediaWiki wiki syntax] page for more information.
 +
 
 +
== Commenting on pages ==
 +
 
 +
If you'd like to comment on pages, please click on "discussion" on the top of a page.

Revision as of 16:57, 10 April 2013

This page describes conventions that should be followed on the SPDX wiki. You can also read the page on getting started.

SubPages

This wiki uses subpages to provide a hierarchy. For example, the minutes for the business team are located under Business Team/Minutes.

When you add a new page, please make sure to use the correct hierarchy. If you want to create a new business related page, choose Business Team/name of page If you'd like to add new business minutes, add them as Business Team/Minutes/YYYY-MM-DD

Categories

We use categories to organize pages. You should add one of these categories at the bottom of each new page:

  • [[Category:Business]]
  • [[Category:General]]
  • [[Category:Legal]]
  • [[Category:Technical]]

Adding minutes

The list of minutes is updated automatically but this requires minutes to be added in the right location. Please use XXX Team/Minutes/YYYY-MM-DD for new minutes.

Additionally, minutes should have the category [[Category:Minutes]] in addition to the category defining the subject area.

Headings

Make sure not to use a heading starting with = as this reserved for the title of the page. Headings should start with ==. See the MediaWiki wiki syntax page for more information.

Commenting on pages

If you'd like to comment on pages, please click on "discussion" on the top of a page.