WG/OBIT/Mediawiki Organization: Difference between revisions

From wiki.occupyboston.org
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
In the interest of organization and consistency, [[WG/OBIT|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.  
In the interest of organization and consistency, [[WG/OBIT|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.  


<br>
== Instructions ==
 
For every page, please provide the following:
==
* Proper page name for navigation - see the '''Naming Tree''' (next section)
----
* Objective language - see Wikipedia's [http://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view|Neutral Point of View] and [http://en.wikipedia.org/wiki/Wikipedia:What_Wikipedia_is_not|What Wikipedia Is Not]
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
* Introductory paragraph/sentence to explain existence/function of the page
* Simple formatting, with short headings - mimic the format of nearly any wikipedia page
* Simple formatting, with short headings - mimic the format of nearly any wikipedia page
 
<br>
=== Working Group Guidlines; Page Names ===
=== Naming Tree ===
----
----
All working groups should have their main page located at 'WG/groupname', and all internal group pages should be located at 'WG/groupname/pagename'. &nbsp;This is to assure that pages are easily identified with the working groups which created them.<br>  
All working groups should have their main page located at 'WG/groupname', and all internal group pages should be located at 'WG/groupname/pagename'. &nbsp;This is to assure that pages are easily identified with the working groups which created them.<br>  
Line 21: Line 18:
*WG/OBIT/Wikispaces_Migration  
*WG/OBIT/Wikispaces_Migration  
*WG/OBIT/Mediawiki_Organization
*WG/OBIT/Mediawiki_Organization
[[User:Mcktimo/on_organizing_the_wiki#leave_the_hierarchy_flat|An argument against the naming tree]] -[[User:Mcktimo|Mcktimo]] 00:53, 23 October 2011 (EDT)
<br>
<br>
----
----
<br>
A proposed [[User:Mcktimo/on organizing the wiki/help file|draft help file]] -[[User:Mcktimo|Mcktimo]] 00:53, 23 October 2011 (EDT)
[the following is directly copied and needs to be edited regarding new host]
[the following is directly copied and needs to be edited regarding new host]
<br>
<br><br>
* **Etiquette** should require no more mention than this.
* '''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.
* 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.
* '''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.'
** 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:'''
* **Regarding Discussion:**
** Every page has its own Discussion! Make sure to post on the relevant page.
** Every page has its own Discussion! Make sure to post on the relevant page.
** The Discussion is meant to house **conversation**between members.
** The Discussion is meant to house '''conversation''' between members.
*** Please add comments to existing discussions - that's why they're there!
*** 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.
*** Conversation is greatly aided by query; Where there is a question, there shall become an answer.
* **Making a LARGE contribution?**
* '''Making a LARGE contribution?'''
** Are you posting a document that is hosted only on your personal computer?
** 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 '''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:
*** 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?**
** 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 post a link and a short description on the appropriate existing page (often in the [[Arts/Media|Media]] section).
* **Please note the large number of pages that already exist!**
* '''Please note the large number of pages that already exist!''' Your contribution might be best hosted on an existing page.
** Determine whether your contribution is best hosted on an existing page.
* '''Adding Notes'''
** 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 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.]
** Notes should be in brackets and announced. [Note: This is an example of a note.]


Thank you for reading!
Thank you for reading!

Latest revision as of 17:17, 9 November 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.

Instructions

For every page, please provide the following:

  • Proper page name for navigation - see the Naming Tree (next section)
  • Objective language - see Wikipedia's Point of View and Wikipedia Is Not
  • Introductory paragraph/sentence to explain existence/function of the page
  • Simple formatting, with short headings - mimic the format of nearly any wikipedia page


Naming Tree

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

An argument against the naming tree -Mcktimo 00:53, 23 October 2011 (EDT)


A proposed draft help file -Mcktimo 00:53, 23 October 2011 (EDT)

[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.
    • 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 Media section).
  • Please note the large number of pages that already exist! Your contribution might be best hosted on an existing 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!

Retrieved from "http://wiki.occupyboston.org/wiki/index.php?title=WG/OBIT/Mediawiki_Organization&oldid=5317"