Difference between revisions of "Checklist for Contributors"

From Clicklaw Wikibooks
Jump to navigation Jump to search
m
Line 9: Line 9:




'''1. REVIEW FOR ACCURACY'''
== 1. Review for accuracy ==
<br />
 
For each page you review, please go through the following steps:  
For each page you review, please go through the following steps:  
<br /><br />


'''Read each Page''' — read and take notes on pages assigned to you ............................................................................................................................... {{checkbox}}
=== Read each page ===
<br />
 
'''Review the Law'''
{{checkbox}} Read and take notes on pages assigned to you
* 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 ([http://www.courthouselibrary.ca/training/BCProclamations.aspx BC] & [http://www.courthouselibrary.ca/training/CanadaProclamations.aspx Canada]) for recent changes ........................................................ {{checkbox}}
=== Review the law ===
* Check caselaw — note up cases in [http://www.canlii.org CanLII]; note up key sections of legislation to find new cases .................................................................................................. {{checkbox}}
{{checkbox}} Read laws in context — start with existing citations in the article <br/>
* Consult secondary resources — CLE articles, treatises, journals, etc. ........................................................................................................................... {{checkbox}}
{{checkbox}} Review statutory law — check statutory excerpts and compare to current legislation; check Proclamations ([http://www.courthouselibrary.ca/training/BCProclamations.aspx BC] & [http://www.courthouselibrary.ca/training/CanadaProclamations.aspx Canada]) for recent changes <br/>
'''Verify Statements and Specifics'''
{{checkbox}} Check caselaw — note up cases in [http://www.canlii.org CanLII]; note up key sections of legislation to find new cases <br/>
* Procedural steps — have rules or policies changed? .............................................................................................................................................. {{checkbox}}
{{checkbox}} Consult secondary resources — CLE articles, treatises, journals, etc.
* Forms— has a form changed name or been replaced? ................................................................................................................................................ {{checkbox}}
 
* Deadlines — readers rely on these being correct ................................................................................................................................................. {{checkbox}}
=== Verify statements and specifics ===
* Monetary amounts, costs or limits — have these details changed? ................................................................................................................................. {{checkbox}}
{{checkbox}} Procedural steps — have rules or policies changed? <br/>
'''Resource Links'''
{{checkbox}} Forms— has a form changed name or been replaced? <br/>
* Check existing links — make sure they work and ALSO make sure they still point to the intended content .......................................................................................... {{checkbox}}
{{checkbox}} Deadlines — readers rely on these being correct <br/>
* Best external resources — have newer resources arrived and did old ones get stale? .............................................................................................................. {{checkbox}}
{{checkbox}} Monetary amounts, costs or limits — have these details changed? <br/>
* Best internal links — are concepts discussed that could be cross linked to more Wikibooks and pages? ............................................................................................ {{checkbox}}
 
<br />
=== Resource Links ===
{{checkbox}} Check existing links — make sure they work and ALSO make sure they still point to the intended content <br/>
{{checkbox}} Best external resources — have newer resources arrived and did old ones get stale? <br/>
{{checkbox}} 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:  
Once you've reviewed your pages for legal accuracy, you may decide:  
<br />
# Edit not needed → {{checkbox}} Just update the “[[Clicklaw_Wikibooks_Contributor_Guide#Legal_accuracy_date|last reviewed for legal accuracy]]” date
1. Edit not needed → Just update the “[[Clicklaw_Wikibooks_Contributor_Guide#Legal_accuracy_date|last reviewed for legal accuracy]]” date ...................................................................................................................... {{checkbox}} <br />
# Edit is needed → See step 2 below.  
2. Edit is needed → See step 2.  
 
<br /><br />
== 2. Edit & develop content ==
'''2. EDIT & DEVELOP CONTENT'''
 
<br />
=== Cure existing legal inaccuracies ===
<br />
 
'''Cure Existing Legal Inaccuracies'''
{{checkbox}} Fix incorrect statements — top priority is to correct wrong information, or at least remove the incorrect information <br/>
* Fix incorrect statements — top priority is to correct wrong information, or at least remove the incorrect information ........................................................................... {{checkbox}}
{{checkbox}} Update citations — add new legislation or caselaw (use CanLII's short URLs) <br/>
* Update citations — add new legislation or caselaw (use CanLII's short URLs) ..................................................................................................................... {{checkbox}}
{{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 ===
* Gaps — what is the gap in information and is filling it crucial? ................................................................................................................................ {{checkbox}}
 
* Plain language — keep writing simple (here are some [http://www.plainlanguage.gov/whatisPL/definitions/Kimble.cfm tips]) ....................................................................................................................................... {{checkbox}}
Write new content when tweaking existing content won't do. Please consider:  
* Brevity —edits should clarify meaning, not add length ........................................................................................................................................... {{checkbox}}
 
* Organization — lists, subheadings and short paragraphs make reading easier and orient the reader ................................................................................................ {{checkbox}}
{{checkbox}} Gaps — what is the gap in information and is filling it crucial? <br/>
* Legal references — would more citations benefit or just overwhelm the reader? ................................................................................................................... {{checkbox}}
{{checkbox}} Plain language — keep writing simple (here are some [http://www.plainlanguage.gov/whatisPL/definitions/Kimble.cfm tips]) <br/>
'''Simple & Consistent'''
{{checkbox}} Brevity — edits should clarify meaning, not add length <br/>
* Clarify legal terms, include parenthetical definitions where needed ............................................................................................................................. {{checkbox}}  
{{checkbox}} Organization — lists, subheadings and short paragraphs make reading easier and orient the reader <br/>
* Be consistent in word choice (e.g. choose either “renter” or “tenant”) .......................................................................................................................... {{checkbox}}  
{{checkbox}} Legal references — would more citations benefit or just overwhelm the reader? <br/>
* Familiarize yourself with and apply [[Clicklaw_Wikibooks_Style_Guide|Style Guide]]:  
 
** Correct [[Clicklaw_Wikibooks_Style_Guide#Emphasis|word emphasis]], [[Clicklaw_Wikibooks_Style_Guide#Acronyms|acronyms]], and [[Clicklaw_Wikibooks_Style_Guide#References|case citation style]] ....................................................................................................................................... {{checkbox}}
=== Simple & consistent ===
** Apply [[Clicklaw_Wikibooks_Style_Guide#Lists|bullets/numbered lists]] and [[Clicklaw_Wikibooks_Style_Guide#Punctuation|punctuation]] ................................................................................................................................................... {{checkbox}}
{{checkbox}} Clarify legal terms, include parenthetical definitions where needed <br/>
* Format neutral language — writing "See the chapter/page on…" is better than "Click here for information on…" since Wikibooks are also printed ................................................... {{checkbox}}
{{checkbox}} Be consistent in word choice (e.g. choose either “renter” or “tenant”) <br/>
<br />
{{checkbox}} Familiarize yourself with and apply [[Clicklaw_Wikibooks_Style_Guide|Style Guide]]: <br/>
:{{checkbox}} Correct [[Clicklaw_Wikibooks_Style_Guide#Emphasis|word emphasis]], [[Clicklaw_Wikibooks_Style_Guide#Acronyms|acronyms]], and [[Clicklaw_Wikibooks_Style_Guide#References|case citation style]] <br/>
:{{checkbox}} Apply [[Clicklaw_Wikibooks_Style_Guide#Lists|bullets/numbered lists]] and [[Clicklaw_Wikibooks_Style_Guide#Punctuation|punctuation]] <br/>
{{checkbox}} 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 ==
 
{{checkbox}} Is there extraneous information that should be removed? <br/>
{{checkbox}} Is the overall language clear and approachable? <br/>
{{checkbox}} Are there other Wikibooks pages that would be improved by linking to your content? Speak to that other editor


'''3. OPTIONAL CHECKLIST'''
<br />
* Is there extraneous information that should be removed? ......................................................................................................................................... {{checkbox}}
* 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 ................................................................................... {{checkbox}}


{{Template:Navbox for Clicklaw Wikibooks Guide|type=guides}}
{{Template:Navbox for Clicklaw Wikibooks Guide|type=guides}}
<noinclude>__NOGLOSSARY__</noinclude>
<noinclude>__NOGLOSSARY__</noinclude>
[[Category:Clicklaw Wikibooks Guides]]
[[Category:Clicklaw Wikibooks Guides]]

Revision as of 18:33, 9 March 2017

This is a help page for contributors or users.


Please refer to this checklist each time you review your assigned pages, also available in PDF format: Editorial Checklist for Contributors

  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 below.

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:

Correct word emphasis, acronyms, and case citation style
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