WG/OBIT/Mediawiki Organization: Difference between revisions
No edit summary |
No edit summary |
||
Line 3: | Line 3: | ||
<br> | <br> | ||
== | == | ||
---- | |||
The nature of a wiki is to effectively distribute information in its simplest forms. Every page in the wiki will be more functional if provided the following: | |||
* Proper page name for navigation | |||
* Objective language | |||
* Introductory paragraph/sentence to explain existence/function of the page | |||
* Simple formatting, with short headings - mimic the format of nearly any wikipedia page | |||
All working groups should have their main page located at 'WG/groupname', and all internal group pages should be located at 'WG/groupname/pagename'. This is to assure that pages are easily | === Working Group Guidlines; Page Names === | ||
---- | |||
All working groups should have their main page located at 'WG/groupname', and all internal group pages should be located at 'WG/groupname/pagename'. This is to assure that pages are easily identified with the working groups which created them.<br> | |||
As an example, here is the layout of OBIT's pages: | As an example, here is the layout of OBIT's pages: | ||
Line 14: | Line 22: | ||
*WG/OBIT/Mediawiki_Organization | *WG/OBIT/Mediawiki_Organization | ||
---- | |||
[the following is directly copied and needs to be edited regarding new host] | |||
* **Etiquette** should require no more mention than this. | |||
* Before you begin editing, please quickly **browse the navigation bar** on the left to get a feel for the structure of our wiki. | |||
* **Internal links** are like red blood cells and nerve endings. | |||
** The wiki may not be as intuitively navigable as intended, so information should be linked on **any and all** relevant pages. | |||
** Consider the many paths by which collaborators and visitors may explore the wiki, and try to create a network with **many** 'nerve endings.' | |||
* **Regarding Discussion:** | |||
** Every page has its own Discussion! Make sure to post on the relevant page. | |||
** The Discussion is meant to house **conversation**between members. | |||
*** Please add comments to existing discussions - that's why they're there! | |||
*** Conversation is greatly aided by query; Where there is a question, there shall become an answer. | |||
* **Making a LARGE contribution?** | |||
** Are you posting a document that is hosted only on your personal computer? | |||
*** Please **do not** create a new page or a new Discussion topic to 'host' a text. | |||
*** Please click on 'Manage Wiki' in the top of the navigation bar, then under Content click on 'Files.' Here you can upload documents from your computer, and then revert to the next step: | |||
** Are you posting text, video, or audio that is **already hosted online?** | |||
*** Please post a link and a short description on the appropriate existing page (often in the [[Press]] section). | |||
* **Please note the large number of pages that already exist!** | |||
** Determine whether your contribution is best hosted on an existing page. | |||
** You can create a new page by clicking '**New Page'** at the top of the navigation bar. | |||
* **Tags = Categories:** | |||
** Tags on pages in the wiki **denote categories** used in the aid of site structure and navigation. Check out the [[http://occupyboston.wikispaces.com/tag/list|list of existing tags]]. | |||
** Tags on pages in the wiki are often redundant. All text in the wiki, including page titles, is automatically searchable. | |||
** If you would like a page to appear in a search by a keyword that is not already on the page (possibly due to vagueness of said keyword), create or add to an existing list of "[keywords: in brackets]" a few lines down from the last text on the page (demonstrated on this page). | |||
* **Adding Notes** | |||
** Notes about format and language often belong right on the page. | |||
** Notes should be in brackets and announced. [Note: This is an example of a note.] | |||
Thank you for reading! |
Revision as of 15:00, 19 October 2011
In the interest of organization and consistency, OBIT suggests using the following system to organize the wiki. If any individuals or groups would like assistance or training in the operation of the wiki, or following these guidelines, OBIT will be happy to help.
==
The nature of a wiki is to effectively distribute information in its simplest forms. Every page in the wiki will be more functional if provided the following:
- Proper page name for navigation
- Objective language
- Introductory paragraph/sentence to explain existence/function of the page
- Simple formatting, with short headings - mimic the format of nearly any wikipedia page
Working Group Guidlines; Page Names
All working groups should have their main page located at 'WG/groupname', and all internal group pages should be located at 'WG/groupname/pagename'. This is to assure that pages are easily identified with the working groups which created them.
As an example, here is the layout of OBIT's pages:
- WG/OBIT
- WG/OBIT/todo
- WG/OBIT/Wikispaces_Migration
- WG/OBIT/Mediawiki_Organization
[the following is directly copied and needs to be edited regarding new host]
- **Etiquette** should require no more mention than this.
- Before you begin editing, please quickly **browse the navigation bar** on the left to get a feel for the structure of our wiki.
- **Internal links** are like red blood cells and nerve endings.
- The wiki may not be as intuitively navigable as intended, so information should be linked on **any and all** relevant pages.
- Consider the many paths by which collaborators and visitors may explore the wiki, and try to create a network with **many** 'nerve endings.'
- **Regarding Discussion:**
- Every page has its own Discussion! Make sure to post on the relevant page.
- The Discussion is meant to house **conversation**between members.
- Please add comments to existing discussions - that's why they're there!
- Conversation is greatly aided by query; Where there is a question, there shall become an answer.
- **Making a LARGE contribution?**
- Are you posting a document that is hosted only on your personal computer?
- Please **do not** create a new page or a new Discussion topic to 'host' a text.
- Please click on 'Manage Wiki' in the top of the navigation bar, then under Content click on 'Files.' Here you can upload documents from your computer, and then revert to the next step:
- Are you posting text, video, or audio that is **already hosted online?**
- Please post a link and a short description on the appropriate existing page (often in the Press section).
- Are you posting a document that is hosted only on your personal computer?
- **Please note the large number of pages that already exist!**
- Determine whether your contribution is best hosted on an existing page.
- You can create a new page by clicking '**New Page'** at the top of the navigation bar.
- **Tags = Categories:**
- Tags on pages in the wiki **denote categories** used in the aid of site structure and navigation. Check out the [of existing tags].
- Tags on pages in the wiki are often redundant. All text in the wiki, including page titles, is automatically searchable.
- If you would like a page to appear in a search by a keyword that is not already on the page (possibly due to vagueness of said keyword), create or add to an existing list of "[keywords: in brackets]" a few lines down from the last text on the page (demonstrated on this page).
- **Adding Notes**
- Notes about format and language often belong right on the page.
- Notes should be in brackets and announced. [Note: This is an example of a note.]
Thank you for reading!