Difference between revisions of "Guide for Contributors"

From Social Collaborative Singapore
Jump to: navigation, search
m (Made a note about citation, to be discussed.)
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
==Basic instructions==
 
==Basic instructions==
You can contribute by inserting relevant facts and referencing their source.
+
You can contribute by inserting relevant facts and referencing their sources (citation style to be inserted, section on citations to be edited).
  
We welcome your professional judgment or expert analyses especially if you are able to provide evidence or justification.
+
We welcome your professional judgment or expert analysis, especially if you are able to provide evidence or justification.
  
Note that this is not a platform for service complaints, but your own personal experiences and anecdotes are welcome as long as you put them within squiggly brackets {...}
+
Do note that this is not a platform for service complaints. Your personal experiences and anecdotes (and those of your stakeholders and interviewees) are welcome as long as you put them within squiggly brackets {...}.
  
We also use square brackets [...] to flag knowledge or information gaps.
+
Square brackets [...] are also used to flag knowledge or information gaps.
 
===Starting a new page===
 
===Starting a new page===
If there is a social cause or client group that is not here yet, you may start a new page. If you want to start a page for a client segment, eg 'Adults with Autism', you can link your page within the main 'Disability' Page.
+
If there is a social cause or client group that is not here yet, you may start a new page. If you want to start a page for a client segment, e.g. 'Adults with Autism', you can link your page within the main 'Disability' Page. This allows for greater collaboration as well as relevance.
  
You may please click on this link to cut and paste the [[template]] <nowiki/>to help you get started.
+
To get started,  click on this link to cut and paste our suggested [[template]]<nowiki/>.
 
===Detailed guides===
 
===Detailed guides===
 
For detailed guidelines, please see [[Needs assessment guide|Needs Assessment Guide]]. This is still a work in progress and will be refined over time.
 
For detailed guidelines, please see [[Needs assessment guide|Needs Assessment Guide]]. This is still a work in progress and will be refined over time.
Line 21: Line 21:
 
'''Ensuring Verifiability'''
 
'''Ensuring Verifiability'''
 
*Data found on the site is not meant to be an authoritative source, but a collective source of knowledge. Nonetheless, the information needs to be verified, and as much as possible, current. 
 
*Data found on the site is not meant to be an authoritative source, but a collective source of knowledge. Nonetheless, the information needs to be verified, and as much as possible, current. 
*Each webpage will have a “Last modified date”, which users should use as a reflection of how “live” the information is. 
+
*Each webpage will have a “Last modified date”, which users should use as a reflection of how recent the information is. 
 
'''Broad Guidelines'''
 
'''Broad Guidelines'''
 
*Information put into the Social Collaborative Wiki site should be specific and purpose-driven. The template drawn up aims to provide an element of objectivity for users. 
 
*Information put into the Social Collaborative Wiki site should be specific and purpose-driven. The template drawn up aims to provide an element of objectivity for users. 
Line 33: Line 33:
 
**Anecdotes, however, will not be part of the final report that would be produced. 
 
**Anecdotes, however, will not be part of the final report that would be produced. 
 
'''Developing new flagging titles/tags'''
 
'''Developing new flagging titles/tags'''
*It is plausible that with a larger user base, new flagging titles need to emerge. These can include: 
+
*It is plausible that new flagging titles may be needed with a larger user base,. These can include: 
 
**References to incidents that occurred on social media (Twitter, Facebook) 
 
**References to incidents that occurred on social media (Twitter, Facebook) 
 
**Other media sources (Mothership, The Online Citizen) 
 
**Other media sources (Mothership, The Online Citizen) 
*Tags can be decided at a later point of time by the backbone Knowledge Team, together with the ICT team. 
+
*Tags can be decided at a later point of time by the core Knowledge Team, together with the ICT team. 
 
*Information without citations will also be flagged. If nobody were to produce a citation in a certain amount of time (to be decided), it will be removed by editors. ''If any member of the community wants to contest that decision, it can be done on the “View History” Tag, and under the “Talk” link at the specific edit. (to verify with Joe on where the Talk function is)''
 
*Information without citations will also be flagged. If nobody were to produce a citation in a certain amount of time (to be decided), it will be removed by editors. ''If any member of the community wants to contest that decision, it can be done on the “View History” Tag, and under the “Talk” link at the specific edit. (to verify with Joe on where the Talk function is)''
 
'''Language'''
 
'''Language'''
 
*Language should be as neutral as possible; editors need to flag anecdotes and edit it to reflect a neutral and objective language.
 
*Language should be as neutral as possible; editors need to flag anecdotes and edit it to reflect a neutral and objective language.
*No vulgarities
+
*Vulgarities, slurs and hate speech are strictly prohibited. We seek to create and maintain a safe and inclusive space for everyone (insert details about moderation).
 
'''“Edit Warring”'''
 
'''“Edit Warring”'''
*Occurs when editors who disagree about the content of a page and repeatedly override one another’s contribution.
+
*Occurs when editors who disagree about the content of a page and repeatedly override contributions made.
  
*3 Revert Rule (3RR) is an editorial policy that Wikipedia uses:
+
*3 Revert Rule (3RR) is an editorial policy used by Wikipedia uses:
 
**An editor must not perform more than three reverts on a single page – whether involving the same or different material – within a 24-hour period. Exemptions should include “self-reverting”, reverting obvious vandalism, etc. See here for more.
 
**An editor must not perform more than three reverts on a single page – whether involving the same or different material – within a 24-hour period. Exemptions should include “self-reverting”, reverting obvious vandalism, etc. See here for more.
 
**Editors should amicably resolve their disagreements in the Talk section. Sanctions, like a ban, could be placed on people who violate the 3RR.
 
**Editors should amicably resolve their disagreements in the Talk section. Sanctions, like a ban, could be placed on people who violate the 3RR.

Revision as of 03:04, 15 January 2020

Basic instructions

You can contribute by inserting relevant facts and referencing their sources (citation style to be inserted, section on citations to be edited).

We welcome your professional judgment or expert analysis, especially if you are able to provide evidence or justification.

Do note that this is not a platform for service complaints. Your personal experiences and anecdotes (and those of your stakeholders and interviewees) are welcome as long as you put them within squiggly brackets {...}.

Square brackets [...] are also used to flag knowledge or information gaps.

Starting a new page

If there is a social cause or client group that is not here yet, you may start a new page. If you want to start a page for a client segment, e.g. 'Adults with Autism', you can link your page within the main 'Disability' Page. This allows for greater collaboration as well as relevance.

To get started, click on this link to cut and paste our suggested template.

Detailed guides

For detailed guidelines, please see Needs Assessment Guide. This is still a work in progress and will be refined over time.

Consult the User's Guidefor information on using the wiki software.

Editorial Guidelines

Ensuring Verifiability

  • Data found on the site is not meant to be an authoritative source, but a collective source of knowledge. Nonetheless, the information needs to be verified, and as much as possible, current. 
  • Each webpage will have a “Last modified date”, which users should use as a reflection of how recent the information is. 

Broad Guidelines

  • Information put into the Social Collaborative Wiki site should be specific and purpose-driven. The template drawn up aims to provide an element of objectivity for users. 
  • All edits are reflected in the “Related changes” option on the top left of each page. Users can contest each edit, if they so choose to do so, with the “Talk” link at each edit. (need to re-verify with Joe)

Content

  • Editors and users should focus on the quality of information provided, that they are accurate and from a credible and verifiable source: 
    • Citing the piece of work itself (article, book, newspaper e.g., The Straits Times, Today, Channel NewsAsia) 
    • The creator of the work (The writer, Journalist) 
    • The publisher of the work (E.g. NUS press, Ministry of Social and Family Development, etc.) 
  • Anecdotes, or links to anecdotes, can remain on the page, but needs to be flagged. E.g. A complaint on waiting times for specific services will be flagged by editors (or the larger community) as an {anecdote}
    • Anecdotes, however, will not be part of the final report that would be produced. 

Developing new flagging titles/tags

  • It is plausible that new flagging titles may be needed with a larger user base,. These can include: 
    • References to incidents that occurred on social media (Twitter, Facebook) 
    • Other media sources (Mothership, The Online Citizen) 
  • Tags can be decided at a later point of time by the core Knowledge Team, together with the ICT team. 
  • Information without citations will also be flagged. If nobody were to produce a citation in a certain amount of time (to be decided), it will be removed by editors. If any member of the community wants to contest that decision, it can be done on the “View History” Tag, and under the “Talk” link at the specific edit. (to verify with Joe on where the Talk function is)

Language

  • Language should be as neutral as possible; editors need to flag anecdotes and edit it to reflect a neutral and objective language.
  • Vulgarities, slurs and hate speech are strictly prohibited. We seek to create and maintain a safe and inclusive space for everyone (insert details about moderation).

“Edit Warring”

  • Occurs when editors who disagree about the content of a page and repeatedly override contributions made.
  • 3 Revert Rule (3RR) is an editorial policy used by Wikipedia uses:
    • An editor must not perform more than three reverts on a single page – whether involving the same or different material – within a 24-hour period. Exemptions should include “self-reverting”, reverting obvious vandalism, etc. See here for more.
    • Editors should amicably resolve their disagreements in the Talk section. Sanctions, like a ban, could be placed on people who violate the 3RR.
    • A third-party opinion could be sought in the event of an ‘edit war’. This should ideally come from someone outside of the community who has a neutral point of view.

Formatting Guide

The Wikipedia formatting guideis available for contributors to do source editing, though most inputs can be done with Wikipedia's new (default) visual editor mode.

Tutorial (click edit to see how to create)

Add table 

Heading Heading
Bread Pie
Butter Ice cream

Upload picture

Go to Insert -> Media

(advanced) Insert picture with hyperlink

Caregiver.jpg

Add Accordion 

click "Edit" to see how to create the accordion as shown below!


Add your content here!!

Edit Navigation Menu

go to: MediaWiki:Tweeki-navbar-left

Name without the "*" refers to the navigation header. Subsequent name with the "*" will be under that header. e.g "Configuration, *Options, *Message" will create a dropdown menu with "Configuration" as the header and the others as the dropdown content.

The name which you user refers to the url/link of the site. e.g "*Children" will direct the user to go to "/Children" page. (*CASE SENSITIVE)

Access the page to know more.

Reference

[1]

[2]

References

  1. Example
  2. Example2