Difference between revisions of "Clicklaw Wikibooks Contributor Guide"

From Clicklaw Wikibooks
Jump to navigation Jump to search
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{GUIDEPAGE}}
{{GUIDEPAGE}}
This is a guide for editors and contributors who have accounts with Clicklaw Wikibooks, and who are actively responsible for editing content.
This is a guide for contributors with Clicklaw Wikibooks accounts. It contains instructions for the technical aspects of editing and updating content.  
Read on to learn about:
* Getting your account set up
* Logging in
* Making edits to pages
The [[Clicklaw Wikibooks Contributor Guide]] will get editors and contributors started. If you are not a ''Wikibooks'' editor or contributor, but handle your organization's content on the main ''Clicklaw'' main [http://www.clicklaw.bc.ca Clicklaw website], see the [[Clicklaw Website Contributor Guide]].


==Getting started==
This guide is to be used in conjunction with the [[Clicklaw Wikibooks Style Guide]], which aims to help contributors produce consistent and clear language, layout, and formatting. Also see the [[Clicklaw Wikibooks Cheatsheet]] for shortcuts for commonly used wiki commands.
===Accounts and contributor bio pages===
====Account setup====
Unless your organization chooses to use a single organization-wide account for making edits, each contributor will receive a username and bio page. Users set their own password once their receive their invitation to log in to Clicklaw Wikibooks. By default Clicklaw Wikibooks uses the editor's first and last name, capitalized accordingly and separated by a space, e.g. "Nate Russell", to form the username. Honorifics, e.g. "Judge" or "QC", are not included in the username, although honorifics can be mentioned elsewhere. If you are an editor but have not yet received an email invitation with your account, contact [http://mailto:wikisupport@clicklaw.bc.ca wikisupport@clicklaw.bc.ca]. Editors set their own passwords and can change their email address using the "Preferences" tab.
====Contributor bio pages====
Editors and contributors with usernames receive a bio page. See [[:Category:Contributor Bio |bio page examples]]. The bio page will link to your content and include your name and a brief professional biography at a minimum. It may also include a link your firm's website, a profile picture, and contact information (phone, email, social media). Bio pages are intended to credit and introduce contributors, but Courthouse Libraries BC must avoid the impression that it promotes the services of certain lawyers over others. Avoid overtly promotional language such as self-laudatory claims and adjectives.
To set up the bio page, we require:
* 100-250 word bio
* website URL, email, and social media accounts (optional)
* profile photo portrait at least 150 px wide (optional)
* any phone number, email or social media accounts you want to include
Those who do not supply a photo will have a generic profile graphic displayed.  
As a matter of style and for consistency of tone, lawyers are referred to in the third person and by their first name. The Clicklaw Wikibooks coordinator may edit bios for length and tone.
 
===Authors, editors and reviewers===
Clicklaw Wikibooks houses content for a number of organizations with publications. Each publication, or wikibook title, may have its own culture and arrangement with people tasked with updating it. An partner organization's work will be carried out by contributors, and these people might be staff of that organization with no wiki skills, freelance contractors who've done wiki work before, or volunteer lawyers, judges, advocates, etc. with a wide range of ability. Some wikibooks, such as those produced by [[Peoples Law School]], are administered by a small team of editors only, while other wikibooks, such as ''[[JP Boyd on Family Law]]'', involve [[:Category:JP Boyd on Family Law Contributors|numerous collaborators]] all of who are volunteers.


===Before you edit===
===Before you edit===
Line 28: Line 8:
Have you been invited to edit a particular title? Are you certain the page you're about to edit is part of the right wikibook title, and does not belong to a different wikibook?
Have you been invited to edit a particular title? Are you certain the page you're about to edit is part of the right wikibook title, and does not belong to a different wikibook?


Be conscientious about which page you are editing. Please only edit pages from those titles (or chapters within titles) for which you are responsible.  Generally, let your discretion guide you, or email [mailto:wikisupport@clicklaw.bc.ca?Subject=Wikibooks%20Contributor%20Support wikisupport@clicklaw.bc.ca] for help.  
Be conscientious about which page you are editing. Please only edit pages from those titles (or chapters within titles) for which you are responsible.  Let your discretion guide you, or email [mailto:wikisupport@clicklaw.bc.ca?Subject=Wikibooks%20Contributor%20Support wikisupport@clicklaw.bc.ca] for help.  


That said...
That said...


====Relax, you can't screw up====
====Relax, you can't screw up====
Having asked you to be mindful of the pages you edit, take comfort in knowing that you literally can't damage a page so badly that it cannot be restored.
Having asked you to be mindful of the pages you edit, take comfort in knowing you literally can't damage a page so badly that it cannot be restored.


See [[#Undoing changes |Undoing Changes]].
See [[#Undoing changes |Undoing Changes]].
====If we haven't taught you how to do it, ask us how (or leave it be)====
A minimum knowledge of the tools is required. Other than knowing how to log in, navigate around, and where to find things like the "Edit" tab, you will need to know how to:
# create (or fix) links to cases, legislation, other web resources,
# make lists (like this numbered list),
# create emphasis for key words or documents using ''italics'', or in rare cases '''bold''',
# divide pages with section headings and subheadings,
# indent paragraphs or blocks of text,
# create text in a <tt>plain format</tt> (for legislation excerpts), and
# understand a few technical things that are happening and the limited things you need to know to:
#*change what alert boxes are saying on pages,
#*work with your contributor bio page,
#*understand some of the weird coding and know what to leave alone,
#*''maybe'' change the contents of tables, and
#*participate in Discussion pages (these are locked down so only editors can see Discussions about a page).
This page shows you how to do the above. You are not expected to do anything technically beyond what is explained here.
If you have questions, email us at [mailto:wikisupport@clicklaw.bc.ca wikisupport@clicklaw.bc.ca]
===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.
#You will receive an email from "wikisupport@clicklaw.bc.ca" containing your username and password.
#Go to http://wiki.clicklaw.bc.ca/.
#Use the "Log in" button at the top right to log in with the username and password supplied in the email.
#Change your password to something secure that you will remember (if you need to find the Change Password page, it’s http://wiki.clicklaw.bc.ca/index.php?title=Special:ChangePassword).
[[File:Logging_in_to_your_new_account.png | border|link=]]
====Setting up your Watchlist and alerts====
There are thousands of pages on Clicklaw Wikibooks, but are you responsible for more than half a dozen?
Make sure to click the ''star'' icon on all pages assigned to you, and also add your contributor bio page. This ensures you are monitoring pages in case other editors make changes or visitors leave feedback. Do this once for your pages at the account setup stage.
Here is how:
#ensure you are [[Clicklaw Wikibooks Contributor Guide#Logging in to your new account | logged in]]
#Visit a page you are responsible for
#Click the star icon for that page<br /><br />[[File:Star_icon_adds_to_Watchlist.png | border|800px | link=]]
#Repeat steps 2 and 3 for all pages you're responsible for
#Make sure your account preferences are set to receive emails when pages on your Watchlist are changed <br /><br />[[File:Watchlist_email_preferences.png | border|800px | link=]]
Organizations with one username and account for editing might be responsible for dozens of pages, but organizations should still take this step.
Email alerts will be sent when pages you watch are altered, however feedback left by visitors to the site will not generate an email alert. To see feedback from your watched pages while logged in, visit: http://wiki.clicklaw.bc.ca/index.php?title=Special:ArticleFeedbackv5Watchlist


===The "Edit" screen===
===The "Edit" screen===
Are you at the page you want to edit? Are you logged in? If yes, you can start editing.
Are you at the page you want to edit? Are you logged in? If yes, you can start editing. Please refer to the [[Clicklaw Wikibooks Style Guide]] before/while making edits.
#Click on the "Edit" tab or click on the "edit" link beside a particular section (if you only want to edit the text for a certain section of a page).<br /><br />[[File:Editing_a_page_on_the_wiki.png | border|800px | link=]]<br /><br />
#Click on the "Edit" tab or click on the "edit" link beside a particular section (if you only want to edit the text for a certain section of a page).<br /><br />[[File:Editing_a_page_on_the_wiki.png | border|800px | link=]]<br /><br />
#You can make changes to the text in the edit window, and click on the “Save page” button to save your changes.<br /><br />[[File:Editing_a_page_on_the_wiki_2.png |border| 900px | link=]]
#You can make changes to the text in the edit window, and click on the “Save page” button to save your changes.<br /><br />[[File:Editing_a_page_on_the_wiki_2.png |border| 900px | link=]]
Line 89: Line 27:
|text ='''Tip:''' See the [[Clicklaw Wikibooks Cheatsheet]] for the most basic tips on editing.
|text ='''Tip:''' See the [[Clicklaw Wikibooks Cheatsheet]] for the most basic tips on editing.
}}
}}
Clicklaw Wikibooks uses a simple markup language to control how content looks, but to start off, you don't need to know much about this markup language. Buttons along the top of the edit window frame do most of the formatting and wiki markup for you.  
Clicklaw Wikibooks uses a simple markup language to control how content looks, but to start off, you need not know much about this markup language. Buttons along the top of the edit window frame do most of the formatting and wiki markup for you.  


=== Bold ===
=== Bold ===
Line 96: Line 34:
   
   
In the edit screen, selecting text then clicking the Bold button will apply the wiki markup to make the text appear bold.
In the edit screen, selecting text then clicking the Bold button will apply the wiki markup to make the text appear bold.
Bold text is rarely called for by the [[Clicklaw Wikibooks Style Guide]]. Italics are preferred for giving emphasis. That said, it is sometimes appropriate to bold the first word in a list item.
Bold text is rarely called for by the [[Clicklaw Wikibooks Style Guide]]. Italics are preferred for giving emphasis. However, it is sometimes appropriate to bold the first word in a list item.
You can create bold text manually by enclosing one or more words in sets of three apostrophes.  
You can create bold text manually by enclosing one or more words in sets of three apostrophes.  


Line 107: Line 45:
[[File:Edit toolbar italic.png|framed|link=]]
[[File:Edit toolbar italic.png|framed|link=]]
In the edit screen, selecting text then clicking the Italic button will apply the wiki markup to make the text appear in italics.  
In the edit screen, selecting text then clicking the Italic button will apply the wiki markup to make the text appear in italics.  
Use Italics sparingly to add emphasis to words that are unfamiliar or to disambiguate ones that the reader might mistake. Italics are used to cite cases, legislation or certain other sources. Consult the [[Clicklaw Wikibooks Style Guide]] for guidelines on when to use italics.  
Use Italics sparingly to add emphasis to words that are unfamiliar or to disambiguate ones that the reader might mistake. Italics are also used to cite cases, legislation or certain other sources.  


To create italic text manually, enclose one or more words in sets of two apostrophes.
To create italic text manually, enclose one or more words in sets of two apostrophes.
Line 117: Line 55:
=== Links ===
=== Links ===
==== Link to another website====
==== Link to another website====
Examples of external links include any link to another website, or even a PDF or DOC file available somewhere online. Cases on CanLII, for instance, require external links. The simplest way to insert an external link is to just type the full URL, including the <code><nowiki>http://</nowiki></code> prefix.  
Examples of external links include any link to another website, or even a PDF or DOC file somewhere online. Cases on CanLII, for instance, require external links. The simplest way to insert an external link is to just type the full URL, including the <code><nowiki>http://</nowiki></code> prefix.  
Typing:
Typing:
:<pre>For more information on the Court of Appeal process, visit http://www.courtofappealbc.ca</pre>
:<pre>For more information on the Court of Appeal process, visit http://www.courtofappealbc.ca</pre>
Line 125: Line 63:


[[File:Edit toolbar link.png|framed|link=]]
[[File:Edit toolbar link.png|framed|link=]]
Much of the time, you won't want the link to appear so obvious. To have other words appear with links to online resources, select the text you want to contain the link, then click the Link button. You will be prompted to enter the URL (the link to the online resource). Make sure to select "To an external web page", then click "Insert link".
Much of the time, you won't want the link to appear so obvious. To have other words appear with links to online resources, select the text you want to contain the link, then click the Link button. You will be prompted to enter the URL (the link to the online resource). Select "To an external web page", then click "Insert link".




Line 135: Line 73:
==== Link to another wiki page ====
==== Link to another wiki page ====
[[File:Edit toolbar link.png|framed|link=]]
[[File:Edit toolbar link.png|framed|link=]]
One page in a wiki often naturally leads to another page on the same wiki. For example, here is a link to the [[Clicklaw Wikibooks Style Guide]], which is a Clicklaw Wikibooks page. To make an internal link, click the Link button. You will be prompted to enter the target page, which must be the exact name of the page, and the text to display for the link. Make sure to select "To a wiki page" at the bottom, then click "Insert link".
One page in a wiki often naturally leads to another page on the same wiki. Here is a link to the [[Clicklaw Wikibooks Style Guide]], which is a Clicklaw Wikibooks page. To make an internal link, click the Link button. You will be prompted to enter the target page, which must be the exact name of the page, and the text to display for the link. Select "To a wiki page" at the bottom, then click "Insert link".


Typing:
Typing:
Line 144: Line 82:


==== Link to a location on the same wiki page ====
==== Link to a location on the same wiki page ====
Sometimes, you may need to make a reference to a section within the same page.
Sometimes, you may need to refer to a section within the same page.


Typing:
Typing:
Line 152: Line 90:


==== Link to a location on another wiki page ====
==== Link to a location on another wiki page ====
In some cases, you may need to direct readers to only a section on another wiki page. For example, when the section you are referring to is located in the middle of a lengthy wiki page. If you provided a link to the page, it would be confusing for the readers to land at the beginning of the page.
Sometimes a reader only needs to see a small section of a larger wiki page. When that section is in the middle of a long page it can be hard for the reader to find. Alternately, you can save the reader from scrolling by building a targeted link to that relevant section.  


Typing:
Typing:
Line 158: Line 96:
Will look like this when you save or preview the page:
Will look like this when you save or preview the page:
:To learn how to name a wiki page, read about [[Clicklaw Wikibooks Style Guide#Page titles | page naming convention]].
:To learn how to name a wiki page, read about [[Clicklaw Wikibooks Style Guide#Page titles | page naming convention]].
=== Example of a court decision citation and link in proper wiki format ===
Typing: <pre>''[http://canlii.ca/t/2d35m Domirti v. Domirti]'', 2010 BCCA 472</pre>
Will cause this nice mix of italics and working links according to the [[Style Guide]]:
:''[http://canlii.ca/t/2d35m Domirti v. Domirti]'', 2010 BCCA 472
A case with no link available would be typed: <pre>''Mareva Compania Naviera S.A. v. International Bulkcarriers S.A.'', [1980] 1 All E.R. 213</pre>
It would look like this:
:''Mareva Compania Naviera S.A. v. International Bulkcarriers S.A.'', [1980] 1 All E.R. 213


== Headings and subheadings==
== Headings and subheadings==
[[File:Edit toolbar heading.png|framed|link=]]
[[File:Edit toolbar heading.png|framed|link=]]
Clicklaw Wikibook pages rely heavily on in page headings and subheadings to break up content and to improve navigation.
Clicklaw Wikibook pages rely heavily on in page headings and subheadings to break up content and to improve navigation.
Select the words that you want to become a heading, then select the Heading level from the Advanced menu. The results, when saved, will give you a primary section heading in the text of an article.
Select what you want to become a heading, then select the Heading level from the Advanced menu. The results, when saved, will give you a primary section heading in the text of an article.
Headings within a page can also be produced by typing multiple equal signs, and you are not restricted to a single, primary level of header. A primary section heading is achieved by typing: <pre>==Words in primary heading==</pre>
Headings within a page can also be produced by typing multiple equal signs, and you are not restricted to a single, primary level of header. A primary section heading is achieved by typing: <pre>==Words in primary heading==</pre>


Line 169: Line 118:
A maximum of five heading levels is possible. Just keep adding more equal sign symbols. Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit screen. (Only two or more consecutive paragraph breaks will add white space between paragraphs of text in the page once saved.)
A maximum of five heading levels is possible. Just keep adding more equal sign symbols. Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit screen. (Only two or more consecutive paragraph breaks will add white space between paragraphs of text in the page once saved.)


The following points apply to in page headings:
These points apply to in-page headings:


* Use ''sentence case'' for section headings — that is, the initial letter of a title is capitalized; otherwise, capital letters are used only where they would be used in a normal sentence.
* Use ''sentence case'' for section headings — that is, the initial letter of a title is capitalized; otherwise, capital letters are used only where they would be used in a normal sentence.
Line 176: Line 125:


==Lists==
==Lists==
The [[Clicklaw Wikibooks Style Guide]] calls for the use of ''bulleted'' lists to break up serial information where the order is not important, and ''numbered'' lists where steps or some other sequence is important to understand the information.  
The [[Clicklaw Wikibooks Style Guide]] calls for using ''bulleted'' lists to break up serial information where the order is not important, and ''numbered'' lists where steps or some other sequence is important to understand the information.  


The edit toolbar has the buttons for making lists in the Advanced menu. They are also simple to create as you type. Authorities on plain language writing tend to agree that lists generally make information easier to absorb.
The edit toolbar has the buttons for making lists in the Advanced menu. They are also simple to create as you type. Authorities on plain language writing agree that lists make information easier to absorb.


[[File:Edit toolbar numbered list.png|framed|link=]]
[[File:Edit toolbar numbered list.png|framed|link=]]
Line 186: Line 135:
=== Making a list ===
=== Making a list ===
Once you are logged in, and are in the Edit screen of the page you want to change:
Once you are logged in, and are in the Edit screen of the page you want to change:
* '''Numbered list''': Place each list item on its own line, and start each line with a pound symbol "<nowiki>#</nowiki>". Click "Show preview" to see the list. Notice that the numbered list automatically ends at the last line that you started with a pound symbol. Alternatively, you can select the lines and click the Numbered List button.
* '''Numbered list''': Place each list item on its own line, and start each line with a pound symbol "<nowiki>#</nowiki>". Click "Show preview" to see the list. Notice that the numbered list automatically ends at the last line you started with a pound symbol. Alternatively, you can select the lines and click the Numbered List button.


* '''Bulleted list''': To make a list with bullets, follow the same steps as for a numbered list, but replace the pound symbol with an asterix. You can also use the Bulleted List button.  
* '''Bulleted list''': To make a list with bullets, follow the same steps as for a numbered list, but replace the pound symbol with an asterisk. You can also use the Bulleted List button.  


=== List examples ===
=== List examples ===
Line 216: Line 165:
* Blue
* Blue
|}
|}
More complicated lists with sublists are achieved by adding an extra pound or asterix symbol beside items you want to appear as indented subordinate list. Lists can include a subordinate list of another type, for example a numbered list can break off into a series of points in a bulleted list, or vice versa.   
More complicated lists with sublists are achieved by adding an extra pound or asterix symbol beside items you want to appear as indented subordinate list. Lists can include a mix of bullets and numbers at different levels.   
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 282: Line 231:


===Embedding images===
===Embedding images===
There are several ways to embed an image — however only a couple work well and support PDF, EPUB, and print-on-demand viewing. Consistency is important, so please use the following approach:
There are several ways to embed an image — however only a couple work well and support PDF, EPUB, and print-on-demand viewing. Consistency is important, so please use this approach:
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 299: Line 248:


===Videos===
===Videos===
Clicklaw Wikibooks supports videos embedded from Youtube. You will need to be working with videos that you have already uploaded to Youtube directly. You cannot upload videos to the Clicklaw Wikibooks directly.
Clicklaw Wikibooks supports videos embedded from Youtube. You will need to be working with videos you have already uploaded to Youtube directly. You cannot upload videos to Clicklaw Wikibooks directly.


You have two options:
You have two options:
Line 305: Line 254:
# right aligned videos
# right aligned videos


The following script might look complicated, but you are only going to be changing one thing. You will only be changing the unique identifier, ''e.g. ivsBIwncoiY''. This is the unique alphanumeric string found at the end of a Youtube video's "Share" link.
These script might look complicated, but you will only be changing one thing: the ''unique identifier,'' ''e.g. ivsBIwncoiY''. This is the unique alphanumeric string found at the end of a Youtube video's "Share" link.


To embed a video (left aligned) type:
To embed a video (left aligned) type:
Line 326: Line 275:
|{{Videoright || video = {{#ev:youtube|ivsBIwncoiY|350|right}} }}
|{{Videoright || video = {{#ev:youtube|ivsBIwncoiY|350|right}} }}
|}
|}
==Legal accuracy date==
Most pages advertise the last date of legal review. This is important for readers who want current legal information. The notice sits at the bottom of the page and looks like this:
{{REVIEWED | reviewer = [[Audrey Jun]], September 2016}}
There are two instances when the legal accuracy date notice on a page should be updated:
# the page has been reviewed in its entirety for legal accuracy and no change is required
# the page has been reviewed in its entirety for legal accuracy, changes were required, and all changes have been made
Contributors can change the legal accuracy date by:
* logging in
* going to the relevant page
* selecting Edit mode
* changing the month and year in this line:
:<pre> {{REVIEWED | reviewer = [[Audrey Jun]], September 2016}}</pre>
* clicking "Save page"


==Undoing changes==
==Undoing changes==
Line 332: Line 298:
When viewing a page's history tab:
When viewing a page's history tab:
* Selecting '''Undo''' on the current version will show you the difference between it and the next most recent version, and you can then select "Save page" to restore the earlier of the two versions.
* Selecting '''Undo''' on the current version will show you the difference between it and the next most recent version, and you can then select "Save page" to restore the earlier of the two versions.
* Selecting '''Rollback''' on the current version of a page will undo all of the recent changes by the contributor who had saved that current version, with the effect of rewinding the page back to the most recent version saved by someone other than that contributor.
* Selecting '''Rollback''' is usually overkill. This undoes all recent changes by that contributor back to the last version saved by another user other than that contributor. Do not use this option unless you are sure.
 
==Advanced features==
===Watchlist===
Account holders, including all editors and contributors, have the option of adding pages to a watchlist so they can follow content that they are responsible for and receive a notification when the pages are altered. You receive email notifications (see [[Clicklaw Wikibooks Contributor Guide#Email notification | setting up email notificaiton]]) or be shown an overview of the changes from the [[Special:Watchlist | Watchlist]] page.


====Adding pages to watchlist====
==Watchlists and user feedback== <!-- Do not remove or change the title of this heading since it is anchored as a help link in the article feedback tool-->
As an editor, certain pages (or whole titles) are assigned to you. Visitors can leave feedback on your pages, which can sometimes serve useful information on how to improve the content. Starting in 2020, visitors leaving feedback on your pages will trigger an email alert so you can see what they've said. The email will include a link for you to log in and check off the feedback as resolved.


To add a page to your watchlist you must be logged in. From the page you wish to add, click the star icon beside the "History" tab. [[File:Adding_a_page_to_the_watchlist.png  |border| 900px | link=]]
See [[Notifications to Contributors if Users Leave Feedback]] for more instructions.


==== View your watchlist ====
==Advanced features==
 
Access the [[Special:Watchlist | Watchlist]] from the top menu, or from the left menu. Once you are on the My Watchlist page, you should see a list of the recent changes from the last several days.
 
[[File:Viewing_the_watchlist.png  |border| 900px | link=]]
 
==== Edit your watchlist ====
Delete pages you no longer want to watch or receive notifications about. Check the box beside the name of the page you want to delete from the watchlist, then click "Remove titles". The pages will be deleted from the watchlist only, not from the wiki.
 
[[File:Changing_the_watchlist.png  |border| 900px | link=]]
 
==== Email notifications for watchlist ====
To enable email notification, which will let you know as soon as an edit is made to a page you watch, select "Preferences" from the top menu, select the "User profile" tab, then at the bottom under "E-mail options" select "E-mail me when a page or a file on my watchlist is changed."
You can also control notifications about changes to your user talk page through this menu.
 
[[File:Email_notification_watchlist.png  |border| 900px | link=]]


===Disabling Glossary/Terminology Popups===
===Disabling Glossary/Terminology Popups===
Line 374: Line 322:


It is common to place this at the end of the text of a page.
It is common to place this at the end of the text of a page.
==Additional resources==
=== Wikibook goals and selection criteria ===
See the [[Clicklaw Wikibooks|About]] page for policies around Clicklaw Wikibooks' [[Clicklaw_Wikibooks#governance|governance]], [[Clicklaw_Wikibooks#Selection_criteria|selection criteria for new titles]], and [[Clicklaw_Wikibooks#Goals|goals]].
=== Best practices for PLEI ===
Clicklaw Wikibooks follows [[Best Practice Guidelines for the Development and Maintenance of Online PLEI in BC| Best Practice Guidelines]] for the development and maintenance of online Public Legal Education and Information (PLEI) in British Columbia.
===Style guide===
The [[Clicklaw Wikibooks Style Guide]] highlights key style and word usage for pages on Clicklaw Wikibooks.
===MediaWiki manual===
The [http://www.mediawiki.org/ MediaWiki] website also includes excellent support material — for example, instructions on [http://www.mediawiki.org/wiki/Help:Navigation navigating a wiki], [http://www.mediawiki.org/wiki/Help:Editing_pages editing pages], and [http://www.mediawiki.org/wiki/User_hub much more]. (MediaWiki is free, open source software that powers Clicklaw Wikibooks, as well as the hugely popular Wikipedia.)
===Plain language writing===
====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 on plain language writing====
* [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]
* [http://www.plainlanguage.gov/whatisPL/definitions/Kimble.cfm Joe Kimble, ''The Elements of Plain Language'' in the ''Michigan Bar Journal'', October 2002]
=== Note about updating resources in Legal Help for British Columbians ===
For contributors updating resources for the guide [[Legal Help for British Columbians]], please see the explanatory note on the [[Resource List for Legal Help for British Columbians]]. (Resources are managed as individual pages that are then automatically consolidated on a single [[Resource List]].)
==For further information==
This Guide is maintained by the Clicklaw site editors. For more information or support, please contact [mailto:wikisupport@clicklaw.bc.ca wikisupport@clicklaw.bc.ca].


{{Template:Navbox for Clicklaw Wikibooks Guide}}
{{Template:Navbox for Clicklaw Wikibooks Guide}}
<noinclude>__NOGLOSSARY__</noinclude>
<noinclude>__NOGLOSSARY__</noinclude>
[[Category:Navigation Page]]
[[Category:Clicklaw Wikibooks Guides]]
[[Category:Clicklaw Wikibooks Guides]]

Latest revision as of 19:50, 6 December 2019

This is a help page for contributors or users.


This is a guide for contributors with Clicklaw Wikibooks accounts. It contains instructions for the technical aspects of editing and updating content.

This guide is to be used in conjunction with the Clicklaw Wikibooks Style Guide, which aims to help contributors produce consistent and clear language, layout, and formatting. Also see the Clicklaw Wikibooks Cheatsheet for shortcuts for commonly used wiki commands.

Before you edit

Know what you're responsible for

Have you been invited to edit a particular title? Are you certain the page you're about to edit is part of the right wikibook title, and does not belong to a different wikibook?

Be conscientious about which page you are editing. Please only edit pages from those titles (or chapters within titles) for which you are responsible. Let your discretion guide you, or email wikisupport@clicklaw.bc.ca for help.

That said...

Relax, you can't screw up

Having asked you to be mindful of the pages you edit, take comfort in knowing you literally can't damage a page so badly that it cannot be restored.

See Undoing Changes.

The "Edit" screen

Are you at the page you want to edit? Are you logged in? If yes, you can start editing. Please refer to the Clicklaw Wikibooks Style Guide before/while making edits.

  1. Click on the "Edit" tab or click on the "edit" link beside a particular section (if you only want to edit the text for a certain section of a page).

    Editing a page on the wiki.png

  2. You can make changes to the text in the edit window, and click on the “Save page” button to save your changes.

    Editing a page on the wiki 2.png

Basic editing tools and formatting

Clicklaw Wikibooks uses a simple markup language to control how content looks, but to start off, you need not know much about this markup language. Buttons along the top of the edit window frame do most of the formatting and wiki markup for you.

Bold

Edit toolbar bold.png

In the edit screen, selecting text then clicking the Bold button will apply the wiki markup to make the text appear bold. Bold text is rarely called for by the Clicklaw Wikibooks Style Guide. Italics are preferred for giving emphasis. However, it is sometimes appropriate to bold the first word in a list item. You can create bold text manually by enclosing one or more words in sets of three apostrophes.

Typing:

I want to make '''this text''' bold.

Will look like this when you save or preview the page:

I want to make this text bold.

Italics

Edit toolbar italic.png

In the edit screen, selecting text then clicking the Italic button will apply the wiki markup to make the text appear in italics. Use Italics sparingly to add emphasis to words that are unfamiliar or to disambiguate ones that the reader might mistake. Italics are also used to cite cases, legislation or certain other sources.

To create italic text manually, enclose one or more words in sets of two apostrophes. Typing:

An ''arquebus'' is an early muzzle-loaded firearm, while an ''aquabus'' is a motorized boat.

Will look like this when you save or preview the page:

An arquebus is an early muzzle-loaded firearm, while an aquabus is a motorized boat.

Links

Link to another website

Examples of external links include any link to another website, or even a PDF or DOC file somewhere online. Cases on CanLII, for instance, require external links. The simplest way to insert an external link is to just type the full URL, including the http:// prefix. Typing:

For more information on the Court of Appeal process, visit http://www.courtofappealbc.ca

Will look like this when you save or preview the page:

For more information on the Court of Appeal process, visit http://www.courtofappealbc.ca.


Edit toolbar link.png

Much of the time, you won't want the link to appear so obvious. To have other words appear with links to online resources, select the text you want to contain the link, then click the Link button. You will be prompted to enter the URL (the link to the online resource). Select "To an external web page", then click "Insert link".


Typing:

For more information, visit the Court of Appeal BC's [http://www.courtofappealbc.ca Online Help Guide].

Will look like this when you save or preview the page:

For more information, visit the Court of Appeal BC's Online Help Guide.

Link to another wiki page

Edit toolbar link.png

One page in a wiki often naturally leads to another page on the same wiki. Here is a link to the Clicklaw Wikibooks Style Guide, which is a Clicklaw Wikibooks page. To make an internal link, click the Link button. You will be prompted to enter the target page, which must be the exact name of the page, and the text to display for the link. Select "To a wiki page" at the bottom, then click "Insert link".

Typing:

Editors are encouraged to read the [[Clicklaw Wikibooks Style Guide | Style Guide]].

Will look like this when you save or preview the page:

Editors are encouraged to read the Style Guide.

Note: twin square brackets are used for internal links.

Link to a location on the same wiki page

Sometimes, you may need to refer to a section within the same page.

Typing:

To learn how to insert links, read [[{{PAGENAME}}#Links | Links]].

Will look like this when you save or preview the page:

To learn how to insert links, read Links.

Link to a location on another wiki page

Sometimes a reader only needs to see a small section of a larger wiki page. When that section is in the middle of a long page it can be hard for the reader to find. Alternately, you can save the reader from scrolling by building a targeted link to that relevant section.

Typing:

To learn how to name a wiki page, read about [[Clicklaw Wikibooks Style Guide#Page titles | page naming convention]].

Will look like this when you save or preview the page:

To learn how to name a wiki page, read about page naming convention.

Example of a court decision citation and link in proper wiki format

Typing:

''[http://canlii.ca/t/2d35m Domirti v. Domirti]'', 2010 BCCA 472

Will cause this nice mix of italics and working links according to the Style Guide:

Domirti v. Domirti, 2010 BCCA 472

A case with no link available would be typed:

''Mareva Compania Naviera S.A. v. International Bulkcarriers S.A.'', [1980] 1 All E.R. 213

It would look like this:

Mareva Compania Naviera S.A. v. International Bulkcarriers S.A., [1980] 1 All E.R. 213

Headings and subheadings

Edit toolbar heading.png

Clicklaw Wikibook pages rely heavily on in page headings and subheadings to break up content and to improve navigation. Select what you want to become a heading, then select the Heading level from the Advanced menu. The results, when saved, will give you a primary section heading in the text of an article.

Headings within a page can also be produced by typing multiple equal signs, and you are not restricted to a single, primary level of header. A primary section heading is achieved by typing:

==Words in primary heading==

A subsection below a primary heading is achieved by typing:

===Words in secondary heading===

A maximum of five heading levels is possible. Just keep adding more equal sign symbols. Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit screen. (Only two or more consecutive paragraph breaks will add white space between paragraphs of text in the page once saved.)

These points apply to in-page headings:

  • Use sentence case for section headings — that is, the initial letter of a title is capitalized; otherwise, capital letters are used only where they would be used in a normal sentence.
  • Headings should not normally contain links, especially where only part of a heading is linked.
  • Section and subsection headings should preferably be unique within a page; otherwise section links may lead to the wrong place.

Lists

The Clicklaw Wikibooks Style Guide calls for using bulleted lists to break up serial information where the order is not important, and numbered lists where steps or some other sequence is important to understand the information.

The edit toolbar has the buttons for making lists in the Advanced menu. They are also simple to create as you type. Authorities on plain language writing agree that lists make information easier to absorb.

Edit toolbar numbered list.png
Edit toolbar bulleted list.png

Making a list

Once you are logged in, and are in the Edit screen of the page you want to change:

  • Numbered list: Place each list item on its own line, and start each line with a pound symbol "#". Click "Show preview" to see the list. Notice that the numbered list automatically ends at the last line you started with a pound symbol. Alternatively, you can select the lines and click the Numbered List button.
  • Bulleted list: To make a list with bullets, follow the same steps as for a numbered list, but replace the pound symbol with an asterisk. You can also use the Bulleted List button.

List examples

Description This wiki code Results in this display on the page
Numbered list # One

# Two
# Three

  1. One
  2. Two
  3. Three
Bulleted list * Red

* Green
* Blue

  • Red
  • Green
  • Blue

More complicated lists with sublists are achieved by adding an extra pound or asterix symbol beside items you want to appear as indented subordinate list. Lists can include a mix of bullets and numbers at different levels.

Description This wiki code Results in this display on the page
A numbered list with a subordinate list that is also numbered. # Item one

# Leads to item two:
## Which itself has at least one sub-item
## And possibly two
## Or even three sub-items
# Then back to the main numbered list and item three

  1. Item one
  2. Leads to item two:
    1. Which itself has at least one sub-item
    2. And possibly two
    3. Or even three sub-items
  3. Then back to the main numbered list and item three
A mixed list. Numbered list with a subordinate bulleted list. # Item one

# Leads to item two:
#* Which itself has at least one sub-item
#* And possibly two
#* Or even three sub-items which all need to be bullets
# Then back to the main list, which continues at item three

  1. Item one
  2. Leads to item two:
    • Which itself has at least one sub-item
    • And possibly two
    • Or even three sub-items which all need to be bullets
  3. Then back to the main list, which continues at item three
A bulleted list with a subordinate list of numbers,
and a further subordinate list of bullets.
* This point is simple.

* This point is complicated, and includes:
*# Item one
*# Item two, which is:
*#* 40% X,
*#* 35% Y, and
*#* 25% Z.
*# Item three
* This last point is simple again.

  • This point is simple.
  • This point is complicated, and includes:
    1. Item one
    2. Item two, which is:
      • 40% X,
      • 35% Y, and
      • 25% Z.
    3. Item three
  • This last point is simple again.

Images and video

Uploading images

To upload an image that you will use in a wikibook, or a contributor profile, select the "Upload file" link from the sidebar navigation menu. It is located under the "Toolbox" header. Please use a descriptive name.

Please restrict your photos to .png or .jpg formats.

Embedding images

There are several ways to embed an image — however only a couple work well and support PDF, EPUB, and print-on-demand viewing. Consistency is important, so please use this approach:

Writing this: ... should produce this:
[[File:DescriptiveImageName.jpg| right | frame | link=| <span style="font-size:60%;">Copyright Information</span>]]
Copyright Information

Obviously, "DescriptiveImageName.jpg" should be replaced with the name of the image you uploaded.

The copyright information may take the form of "Copyright www.shutterstock.com", for example.

Videos

Clicklaw Wikibooks supports videos embedded from Youtube. You will need to be working with videos you have already uploaded to Youtube directly. You cannot upload videos to Clicklaw Wikibooks directly.

You have two options:

  1. left aligned videos
  2. right aligned videos

These script might look complicated, but you will only be changing one thing: the unique identifier, e.g. ivsBIwncoiY. This is the unique alphanumeric string found at the end of a Youtube video's "Share" link.

To embed a video (left aligned) type:

{{Video || video = {{#ev:youtube|ivsBIwncoiY|350|right}} }}
Remember to replace "ivsBIwncoiY" with your own video's unique identifier.

This code should embed a left aligned video:


To embed a video (right aligned) type:

{{Videoright || video = {{#ev:youtube|ivsBIwncoiY|350|right}} }}

Again, remember to replace "ivsBIwncoiY" with your own video's unique identifier.

This code should embed a right aligned video:

Legal accuracy date

Most pages advertise the last date of legal review. This is important for readers who want current legal information. The notice sits at the bottom of the page and looks like this:

This information applies to British Columbia, Canada. Last reviewed for legal accuracy by Audrey Jun, September 2016.


There are two instances when the legal accuracy date notice on a page should be updated:

  1. the page has been reviewed in its entirety for legal accuracy and no change is required
  2. the page has been reviewed in its entirety for legal accuracy, changes were required, and all changes have been made

Contributors can change the legal accuracy date by:

  • logging in
  • going to the relevant page
  • selecting Edit mode
  • changing the month and year in this line:
 {{REVIEWED | reviewer = [[Audrey Jun]], September 2016}}
  • clicking "Save page"

Undoing changes

One of the best things about this wiki platform is that each page has a "History" of older versions, including the one you just saved over. You (or another person) can always undo an edit and restore the older version.

When viewing a page's history tab:

  • Selecting Undo on the current version will show you the difference between it and the next most recent version, and you can then select "Save page" to restore the earlier of the two versions.
  • Selecting Rollback is usually overkill. This undoes all recent changes by that contributor back to the last version saved by another user other than that contributor. Do not use this option unless you are sure.

Watchlists and user feedback

As an editor, certain pages (or whole titles) are assigned to you. Visitors can leave feedback on your pages, which can sometimes serve useful information on how to improve the content. Starting in 2020, visitors leaving feedback on your pages will trigger an email alert so you can see what they've said. The email will include a link for you to log in and check off the feedback as resolved.

See Notifications to Contributors if Users Leave Feedback for more instructions.

Advanced features

Disabling Glossary/Terminology Popups

Terms that appear along with their definitions on the Terminology page will automatically be detected the first time they appear on any article in the Clicklaw Wiki. In general, this saves work, since no manual coding is required to ensure that a legal term will include a definition. The automatic nature of this process, however, will result in false-positives in cases where a defined term also has a common meaning in addition to a legal one (the terms "hearing", and "order" for example).

Disabling a single occurrence of a term

To exclude defined terms from appearing with their pop-up definition (and where it is the first time the term has been used on a page), you should bracket the term with the HTML element:

 <span class="noglossary">term</span> 

A <div> tag will also work but create a separate paragraph that may not be desired.

Disabling definitions for a whole page

To exclude an entire article from receiving glossary popups you need to place one line of text on the page. From the edit screen include the text:

__NOGLOSSARY__

It is common to place this at the end of the text of a page.