Difference between revisions of "Clicklaw Wikibooks Contributor Guide"

Jump to navigation Jump to search
no edit summary
Line 33: Line 33:
This page shows you how to do the above, and you are not expected to do anything technically beyond what is explained here.  
This page shows you how to do the above, and you are not expected to do anything technically beyond what is explained here.  


==Step-by-step guide for Clicklaw Wikibook contributors==
==Logging in to your new account==
===Logging in to your new account===
Everyone who contributes to Clicklaw Wikibooks will be given an account. All of your work is linked to your account, so it’s important to use the same account every time.  
Everyone who contributes to Clicklaw Wikibooks will be given an account. All of your work is linked to your account, so it’s important to use the same account every time.  
#You will receive an email from editor@clicklaw.bc.ca containing your username and password.  
#You will receive an email from editor@clicklaw.bc.ca containing your username and password.  
Line 44: Line 43:
[[File:Logging_in_to_your_new_account.png | border|center|link=]]
[[File:Logging_in_to_your_new_account.png | border|center|link=]]


==Write in plain language==
===A short definition of "Plain English"===
Brian Garner, from ''Legal Writing in Plain English,'' 2001, pp xiv:
<blockquote>A word about "plain English." The phrase certainly shouldn't connote drab and dreary language. Actually, plain English is typically quite interesting to read. It's robust and direct—the opposite of gaudy, pretentious language. You achieve plain English when you use the simplest, most straightforward way of expressing an idea. You can still choose interesting words. But you'll avoid fancy ones that have everyday replacements meaning precisely the same thing.
</blockquote>
===Plain language tips===
We are writing with the public reader in mind, not lawyers or other legal advocates. Depending on the wikibook, you may need to aim for a very low reading level. For example, [[Legal Help for British Columbians]] serves very basic information so people can take the first step towards finding help for their common legal problem. [[JP Boyd on Family Law]], on the other hand, presumes a higher reading level, since it offers motivated self-represented individuals a slightly more detailed description of family law. Both groups of readers benefit from plain language writing methods. 
Some tips to consider when writing or reviewing legal information for the public:
# Think about your reader and question what they know or don't know. 
# Think about questions your readers will have on the topic, and organize your thoughts accordingly.
# Summarize main points using headers.
# Organize steps or similar information with lists.
# Write brief sentences and keep paragraphs short.
# Use common phrases and words.
# Avoid unnecessary descriptive adverbs and words.
# Write in the active voice and keep verb and subject close together.
# Ask another reader to evaluate your writing.
===More reading about plain language===
* [http://www.cba.org/cba/practicelink/cs/plainlanguage1.aspx CBA PracticeLink: Plain language legal writing]
* [http://www.plainlanguage.gov/examples/before_after/index.cfm Before and After Comparisons from www.plainlanguage.gov]
*
===Editing content===
===Editing content===
*[[Editing a Page on Clicklaw Wikibooks]]
*[[Editing a Page on Clicklaw Wikibooks]]

Navigation menu