Difference between revisions of "Checklist for Contributors"

From Clicklaw Wikibooks
Jump to navigation Jump to search
Line 1: Line 1:
Please refer to this checklist each time you review your assigned pages: [[File:Checklist for Contributors (Nov 2016).pdf|thumbnail|Editorial Checklist for Contributors]]
Please refer to this checklist each time you review your assigned pages, also available in an easier-to-read PDF format: [[File:Checklist for Contributors (Nov 2016).pdf|thumbnail|Editorial Checklist for Contributors]]


# The purpose of reviewing pages is to ensure changes in law are reflected in content.   
# The purpose of reviewing pages is to ensure changes in law are reflected in content.   
Line 13: Line 13:
<br /><br />
<br /><br />


'''Read each Page''' — read and take notes on pages assigned to you .......................................
'''Read each Page''' — read and take notes on pages assigned to you ....................................... {{checkbox}}
<br />
<br />
'''Review the Law'''  
'''Review the Law'''  
* Read laws in context — start with existing citations in the article ...................................  
* Read laws in context — start with existing citations in the article ................................... {{checkbox}}
* Review statutory law — check statutory excerpts and compare to current legislation; check Proclamations (BC & Canada) for recent changes ...............................  
* Review statutory law — check statutory excerpts and compare to current legislation; check Proclamations (BC & Canada) for recent changes ............................... {{checkbox}}
* Check caselaw — note up cases in CanLII; note up key sections of legislation to find new cases .............................................................................................  
* Check caselaw — note up cases in CanLII; note up key sections of legislation to find new cases ............................................................................................. {{checkbox}}
* Consult secondary resources — CLE articles, treatises, journals, etc. ..............................  
* Consult secondary resources — CLE articles, treatises, journals, etc. .............................. {{checkbox}}
'''Verify Statements and Specifics'''  
'''Verify Statements and Specifics'''  
* Procedural steps — have rules or policies changed? .......................................................  
* Procedural steps — have rules or policies changed? ....................................................... {{checkbox}}
* Forms— has a form changed name or been replaced? ....................................................  
* Forms— has a form changed name or been replaced? .................................................... {{checkbox}}
* Deadlines — readers rely on these being correct ............................................................  
* Deadlines — readers rely on these being correct ............................................................ {{checkbox}}
* Monetary amounts, costs or limits — have these details changed? ................................  
* Monetary amounts, costs or limits — have these details changed? ................................ {{checkbox}}
'''Resource Links'''  
'''Resource Links'''  
* Check existing links — make sure they work and ALSO make sure they still point to the intended content ..........................................................................................  
* Check existing links — make sure they work and ALSO make sure they still point to the intended content .......................................................................................... {{checkbox}}
* Best external resources — have newer resources arrived and did old ones get stale? ...........................................................................................................................  
* Best external resources — have newer resources arrived and did old ones get stale? ........................................................................................................................... {{checkbox}}
* Best internal links — are concepts discussed that could be cross linked to more Wikibooks and pages? .............................................................................................  
* Best internal links — are concepts discussed that could be cross linked to more Wikibooks and pages? ............................................................................................. {{checkbox}}
<br />
<br />
Once you've reviewed your pages for legal accuracy, you may decide:  
Once you've reviewed your pages for legal accuracy, you may decide:  
<br />
<br />
1. Edit not needed → Just update the “last reviewed for legal accuracy” date .................. 
1. Edit not needed → Just update the “last reviewed for legal accuracy” date .................. {{checkbox}}
2. Edit is needed → See step 2.  
2. Edit is needed → See step 2.  


2. EDIT & DEVELOP CONTENT  
2. EDIT & DEVELOP CONTENT  
Cure Existing Legal Inaccuracies  
Cure Existing Legal Inaccuracies  
• Fix incorrect statements — top priority is to correct wrong information, or at least remove the incorrect information ....................................................................... 
• Fix incorrect statements — top priority is to correct wrong information, or at least remove the incorrect information ....................................................................... {{checkbox}}
•Update citations — add new legislation or caselaw (use CanLII's short URLs) ................................................................................................................................. 
•Update citations — add new legislation or caselaw (use CanLII's short URLs) ................................................................................................................................. {{checkbox}}
•Fix broken links and resources .......................................................................................... 
•Fix broken links and resources .......................................................................................... {{checkbox}}
Develop & Write — write new content when tweaking existing content won't do. Please consider:  
Develop & Write — write new content when tweaking existing content won't do. Please consider:  
• Gaps — what is the gap in information and is filling it crucial? ....................................... 
• Gaps — what is the gap in information and is filling it crucial? ....................................... {{checkbox}}
• Plain language — keep writing simple (here are some tips) ............................................ 
• Plain language — keep writing simple (here are some tips) ............................................ {{checkbox}}
• Brevity —edits should clarify meaning, not add length ................................................... 
• Brevity —edits should clarify meaning, not add length ................................................... {{checkbox}}
•Organization — lists, subheadings and short paragraphs make reading easier and orient the reader ............................................................................................. 
•Organization — lists, subheadings and short paragraphs make reading easier and orient the reader ............................................................................................. {{checkbox}}
•Legal references — would more citations benefit or just overwhelm the reader? .............................................................................................................................. 
•Legal references — would more citations benefit or just overwhelm the reader? .............................................................................................................................. {{checkbox}}
Simple & Consistent  
Simple & Consistent  
• Clarify legal terms, include parenthetical definitions where needed .............................. 
• Clarify legal terms, include parenthetical definitions where needed .............................. {{checkbox}}
•Be consistent in word choice (e.g. choose either “renter” or “tenant”) .......................... 
•Be consistent in word choice (e.g. choose either “renter” or “tenant”) .......................... {{checkbox}}
• Familiarize yourself with and apply Style Guide:  
• Familiarize yourself with and apply Style Guide:  
o Correct word emphasis, acronyms, and case citation style ........................... 
o Correct word emphasis, acronyms, and case citation style ........................... {{checkbox}}
o Apply bullets/numbered lists and punctuation .............................................. 
o Apply bullets/numbered lists and punctuation .............................................. {{checkbox}}
• Format neutral language — writing "See the chapter/page on…" is better than "Click here for information on…" since Wikibooks are also printed ........................ 
• Format neutral language — writing "See the chapter/page on…" is better than "Click here for information on…" since Wikibooks are also printed ........................ {{checkbox}}


3. OPTIONAL CHECKLIST  
3. OPTIONAL CHECKLIST  
• Is there extraneous information that should be removed? ............................................. 
• Is there extraneous information that should be removed? ............................................. {{checkbox}}
•Is the overall language clear and approachable? ............................................................. 
•Is the overall language clear and approachable? ............................................................. {{checkbox}}
•Are there other Wikibooks pages that would be improved by linking to your content? Speak to that other editor ......................................................................... 
•Are there other Wikibooks pages that would be improved by linking to your content? Speak to that other editor ......................................................................... {{checkbox}}

Revision as of 22:01, 18 November 2016

Please refer to this checklist each time you review your assigned pages, also available in an easier-to-read PDF format: File:Checklist for Contributors (Nov 2016).pdf

  1. The purpose of reviewing pages is to ensure changes in law are reflected in content.
  2. Clicklaw Wikibooks provide reliable, up-to-date, plain language information to help British Columbians address legal problems or learn about the law.
  3. Some Wikibooks offer brief, punctual tips — other titles offer more comprehensive guidance.
  4. What is your Wikibook's editorial objective? Consider the purpose, tone and audience of the title as a whole when making edits.


1. REVIEW FOR ACCURACY

For each page you review, please go through the following steps:

Read each Page — read and take notes on pages assigned to you .......................................
Review the Law

  • Read laws in context — start with existing citations in the article ...................................
  • Review statutory law — check statutory excerpts and compare to current legislation; check Proclamations (BC & Canada) for recent changes ...............................
  • Check caselaw — note up cases in CanLII; note up key sections of legislation to find new cases .............................................................................................
  • Consult secondary resources — CLE articles, treatises, journals, etc. ..............................

Verify Statements and Specifics

  • Procedural steps — have rules or policies changed? .......................................................
  • Forms— has a form changed name or been replaced? ....................................................
  • Deadlines — readers rely on these being correct ............................................................
  • Monetary amounts, costs or limits — have these details changed? ................................

Resource Links

  • Check existing links — make sure they work and ALSO make sure they still point to the intended content ..........................................................................................
  • Best external resources — have newer resources arrived and did old ones get stale? ...........................................................................................................................
  • Best internal links — are concepts discussed that could be cross linked to more Wikibooks and pages? .............................................................................................


Once you've reviewed your pages for legal accuracy, you may decide:
1. Edit not needed → Just update the “last reviewed for legal accuracy” date .................. 2. Edit is needed → See step 2.

2. EDIT & DEVELOP CONTENT Cure Existing Legal Inaccuracies • Fix incorrect statements — top priority is to correct wrong information, or at least remove the incorrect information ....................................................................... •Update citations — add new legislation or caselaw (use CanLII's short URLs) ................................................................................................................................. •Fix broken links and resources .......................................................................................... Develop & Write — write new content when tweaking existing content won't do. Please consider: • Gaps — what is the gap in information and is filling it crucial? ....................................... • Plain language — keep writing simple (here are some tips) ............................................ • Brevity —edits should clarify meaning, not add length ................................................... •Organization — lists, subheadings and short paragraphs make reading easier and orient the reader ............................................................................................. •Legal references — would more citations benefit or just overwhelm the reader? .............................................................................................................................. Simple & Consistent • Clarify legal terms, include parenthetical definitions where needed .............................. •Be consistent in word choice (e.g. choose either “renter” or “tenant”) .......................... • Familiarize yourself with and apply Style Guide: o Correct word emphasis, acronyms, and case citation style ........................... o Apply bullets/numbered lists and punctuation .............................................. • Format neutral language — writing "See the chapter/page on…" is better than "Click here for information on…" since Wikibooks are also printed ........................

3. OPTIONAL CHECKLIST • Is there extraneous information that should be removed? ............................................. •Is the overall language clear and approachable? ............................................................. •Are there other Wikibooks pages that would be improved by linking to your content? Speak to that other editor .........................................................................