Help: Difference between revisions

From wiki.occupyboston.org
Jump to navigation Jump to search
mNo edit summary
Line 10: Line 10:
* '''Internal links''' are like nerve endings - they pick up and direct information within the whole. Consider the many paths by which collaborators and visitors might want to explore the wiki, and try to create a network with many 'nerve endings'. Information should be linked on any and all relevant pages.
* '''Internal links''' are like nerve endings - they pick up and direct information within the whole. Consider the many paths by which collaborators and visitors might want to explore the wiki, and try to create a network with many 'nerve endings'. Information should be linked on any and all relevant pages.


==Philosophy and Etiquette==
==Philosophy==
There is a primary cautionary line on every Editing page:
There is a primary cautionary line on every Editing page:
<blockquote style="border: 0px solid blue; font: 14px Times, serif; font-style: italic; padding: 0em;">If you do not want your writing to be edited mercilessly and redistributed at will, do not submit it here. </blockquote>
<blockquote style="border: 0px solid blue; font: 14px Times, serif; font-style: italic; padding: 0em;">If you do not want your writing to be edited mercilessly and redistributed at will, do not submit it here. </blockquote>
* Wikipedia is living proof that crowd-sourced content creation and management can be effective on a global web-space. Anyone can become a content creator, but no one is ever a content 'owner.'  Before you modify a page, please consider the intent of the existing text. There are many authors, and everyone is making their best contributions.  
* Wikipedia is living proof that crowd-sourced content creation and management can be effective on a global web-space. Anyone can become a content creator, but no one is ever a content 'owner.'  Before you modify a page, please consider the intent of the existing text. There are many authors, and everyone is making their best contributions.  
* You can check in with prior editors by using the Discussion and History tabs at the top of every page.  
* You can check in with prior editors by using the Discussion and History tabs at the top of every page.  
** Don't forget to sign your comments by inserting four tildes (<nowiki>~~~~</nowiki>). The wiki will automatically insert a link to your user-page with a time-stamp for the comment. This will help others collaborate with you regarding your notes.
** If you want others to collaborate regarding your notes, '''don't forget to sign your comments''' by inserting four tildes (<nowiki>~~~~</nowiki>). The wiki will automatically insert a link to your user-page and a time-stamp for that comment.
* You can email other users by going to their user-page and clicking the link that appears in the bottom of the side-bar.
* You can email other users by going to their user-page and clicking the link that appears in the bottom of the side-bar. (This will send an email to the address registered with your username.)


===Public vs Personal Space===
===Public vs Personal Space===
Line 24: Line 24:


==Editing==
==Editing==
Use the tabs at the top of every page for Discussion and Editing.
Use the tabs at the top of every page for Discussion and Editing. Practice editing a page in the [[Sandbox]].
* '''Please review your Preferences''' (link in uppermost right corner)
* '''Please review your Preferences''' (link in uppermost right corner)
** Under ''Preferences --> Editing --> Advanced options'', please check the box to ''''Mark all edits minor by default''''. (You can un-check this for every individual edit, right above the 'Save Page' button.)
** Under ''Preferences --> Editing --> Advanced options'', please check the box to ''''Mark all edits minor by default''''. (You can un-check this for every individual edit, right above the 'Save Page' button.)
Line 32: Line 32:
Use <nowiki><br></nowiki> for a new line where you don't want a larger space to appear. Otherwise, just skip an extra line.
Use <nowiki><br></nowiki> for a new line where you don't want a larger space to appear. Otherwise, just skip an extra line.


===Headings===
===Headings and Lists===
* Use headings to create sections and sub-sections on a page. It is recommended to never use the <nowiki>=First Heading=</nowiki> (generally reserved for the Title of the page), but only the <nowiki>==Second==, ===Third===, ====Fourth====</nowiki>, etc.
* Use headings to create sections and sub-sections on a page. It is recommended to <u>always skip <nowiki>=First Heading=</nowiki> (which is generally reserved for the Title of the page) and to only use the <nowiki>==Second==, ===Third===, ====Fourth====</nowiki>, etc.
* Use of headings will automatically create a table of contents. To disable the table of contents, place <nowiki>__NOTOC__</nowiki> anywhere on the page.
** Use of headings will automatically create a <u>table of contents.</u> To disable the table of contents, place <nowiki>__NOTOC__</nowiki> anywhere on the page.
 
===Bulleted/Numbered Lists===
* Use an asterisk (for bullets) or a number sign (for numbering) at the beginning of each line to create a list (this line begins with *)
* Use an asterisk (for bullets) or a number sign (for numbering) at the beginning of each line to create a list (this line begins with *)
*# You can embed numbers/bullets within each other in various levels (this line begins with *#)
*# You can embed numbers/bullets within each other in various levels (this line begins with *#)
Line 46: Line 44:


===Adding Notes===
===Adding Notes===
* Notes about format and language often belong right on the page.
Notes about format and language often belong right on the page. These are apart from the general Discussion, which can be accessed via the tab at the top of the page.
* Notes should be in single brackets and announced as a note. [Note: This is an example of a note.]
* Notes should be in single brackets and announced as a note. [Note: This is an example of a note.]
* To suggest changes that you may not be comfortable making yourself, please add a note to the [[Tasks]] page.
* To suggest changes that you may not be comfortable making yourself, please make others aware by adding a note to the [[Tasks]] page.
* Don't forget your signature (using <nowiki>~~~~</nowiki>), otherwise no one will know how to collaborate with you!


==MediaWiki Help==
==MediaWiki Help Pages==
* Practice editing a page at the [[Sandbox]]
* Editing and formatting: http://meta.wikimedia.org/wiki/Help:Editing#Editing_Basics
* Editing and formatting: http://meta.wikimedia.org/wiki/Help:Editing#Editing_Basics
* General: http://meta.wikimedia.org/wiki/Help:Contents
* General: http://meta.wikimedia.org/wiki/Help:Contents
Line 57: Line 55:
* Magic Words: http://meta.wikimedia.org/wiki/Help:Magic_words
* Magic Words: http://meta.wikimedia.org/wiki/Help:Magic_words
* HTML: http://www.tedmontgomery.com/tutorial/index.html
* HTML: http://www.tedmontgomery.com/tutorial/index.html
Please contact [[WG/OBIT]] for extra help or to address any other concerns.
Please contact [[WG/OBIT]] to address any other concerns. They can often be found in the IRC channel '#OccupyBostonIT'


==Email==
==Email==
''[Note: It is not clear how to set this up, will OBIT please clarify? --[[User:OneKarma|OneKarma]] 13:38, 5 November 2011 (EDT)]''
''[Note: It is not clear how to set this up. OBIT, please clarify? --[[User:OneKarma|OneKarma]] 13:38, 5 November 2011 (EDT)]''


To check your occupyboston.org email address:
To check your occupyboston.org email address:

Revision as of 15:15, 5 November 2011

This wiki is a collaborative and informative space dedicated to Occupy Boston. As authors, we want to not only create the most compelling content, but also organize it in the most intuitive manner. The wiki generally organizes itself as it expands, but here there are a number of guidelines for reference.

Basics

The most important aspect of a wiki is clarity. Every page on the wiki should clearly represent a specific idea. You can clarify the intent of a page (and thereby direct its future use) by adding a precise description of its function, which will strongly promote the healthy growth of the wiki.

Page titles should be short and sweet, and should contain relevant hierarchies if possible. For example, a draft proposal from the Safety WG should be entitled 'Safety/Proposal X'. This creates more navigable sub-spaces for our mass of information.

  • 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 nerve endings - they pick up and direct information within the whole. Consider the many paths by which collaborators and visitors might want to explore the wiki, and try to create a network with many 'nerve endings'. Information should be linked on any and all relevant pages.

Philosophy

There is a primary cautionary line on every Editing page:

If you do not want your writing to be edited mercilessly and redistributed at will, do not submit it here.

  • Wikipedia is living proof that crowd-sourced content creation and management can be effective on a global web-space. Anyone can become a content creator, but no one is ever a content 'owner.' Before you modify a page, please consider the intent of the existing text. There are many authors, and everyone is making their best contributions.
  • You can check in with prior editors by using the Discussion and History tabs at the top of every page.
    • If you want others to collaborate regarding your notes, don't forget to sign your comments by inserting four tildes (~~~~). The wiki will automatically insert a link to your user-page and a time-stamp for that comment.
  • You can email other users by going to their user-page and clicking the link that appears in the bottom of the side-bar. (This will send an email to the address registered with your username.)

Public vs Personal Space

As a general guideline, please consider the main structure to be a public face of Occupy Boston. It should have the appearance of professionalism, inviting readers with clarity, brevity, and importance.

It is suggested that users keep their works-in-progress, personal manifestos, and reference collections in their own user web-space. Create sub-pages in your user-space by naming convention, such as User:Username/Page Name.

Editing

Use the tabs at the top of every page for Discussion and Editing. Practice editing a page in the Sandbox.

  • Please review your Preferences (link in uppermost right corner)
    • Under Preferences --> Editing --> Advanced options, please check the box to 'Mark all edits minor by default'. (You can un-check this for every individual edit, right above the 'Save Page' button.)
  • Nothing can ever be truly un-done - every edit is archived within the History of each page.

Formatting

Use <br> for a new line where you don't want a larger space to appear. Otherwise, just skip an extra line.

Headings and Lists

  • Use headings to create sections and sub-sections on a page. It is recommended to always skip =First Heading= (which is generally reserved for the Title of the page) and to only use the ==Second==, ===Third===, ====Fourth====, etc.
    • Use of headings will automatically create a table of contents. To disable the table of contents, place __NOTOC__ anywhere on the page.
  • Use an asterisk (for bullets) or a number sign (for numbering) at the beginning of each line to create a list (this line begins with *)
    1. You can embed numbers/bullets within each other in various levels (this line begins with *#)

Links and Files

  • Internal links are made with double brackets, such as [[Page Name]]
  • External links are made with single brackets, such as [http://someurl.com Display Text]
  • Upload files (documents, images, videos, etc) from your computer via link in the bottom of the side-bar.

Adding Notes

Notes about format and language often belong right on the page. These are apart from the general Discussion, which can be accessed via the tab at the top of the page.

  • Notes should be in single brackets and announced as a note. [Note: This is an example of a note.]
  • To suggest changes that you may not be comfortable making yourself, please make others aware by adding a note to the Tasks page.
  • Don't forget your signature (using ~~~~), otherwise no one will know how to collaborate with you!

MediaWiki Help Pages

Please contact WG/OBIT to address any other concerns. They can often be found in the IRC channel '#OccupyBostonIT'

Email

[Note: It is not clear how to set this up. OBIT, please clarify? --OneKarma 13:38, 5 November 2011 (EDT)]

To check your occupyboston.org email address:

  • go to the May First/People's Link member page,
  • choose Boggs as the server, and
  • enter your Username and Password.

For other email questions, check the FAQs.

Mailing Lists

If you need to manage your mailing list, please read over these FAQs. If you cannot find and answer to your question, email obit@lists.mayfirst.org and ask for assistance.

We use software called Mailman for mailing lists. You can change how your address appears on the list by logging into the mailing list at https://lists.mayfirst.org/mailman/listinfo/LIST_NAME and changing your settings.

If you do not know your password, you can put your email address in at the bottom and click submit and receive a password reminder, then you can log in. To keep your membership hidden, visit the page at https://lists.mayfirst.org/mailman/options/LIST_NAME - you will see an option that says "Conceal yourself from subscriber list?" check the "Yes" box, and save your options.

This can also be set globally by the list administrator, so you might want to ask on the list itself to have this option turned off.

If you need to set up a new email address email obit@lists.mayfirst.org and someone will set up a list for you.

Moderation and Notices

  • The trick for reducing the number of notices is to set the filter here: [1]
  • "Action to take for postings from non-members for which no explicit action is defined" -> Accept
    • The filter here: [2]
  • "What steps are required for subscription?" -> Confirm
    • The filter here: [3]
  • "Should administrator get notices of subscribes and unsubscribes?" -> No

With these settings, you shouldn't get any requests for anything. This means the lists will be wide open, but it should also permit a more free flow of information without a bunch of notices.