≪ View Page

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
facilities:slq_wiki:wiki_style_guide [2020/06/15 09:19]
Michelle Brown [SLQ Wiki Contributors Guidelines] 		facilities:slq_wiki:wiki_style_guide [2021/11/22 11:16] (current)
James Collins
Line 1: Line 1:
-======SLQ Wiki Contributors Guidelines====== +====== SLQ Wiki Contributors Guidelines ======
- +
-==== ====+
  
 This style guide is intended to cover the **Design** and **Written** tone, style and conventions used when creating or editing content for the SLQ Wiki. Dokuwiki plugins used in the SLQ Wiki are also covered. This style guide is intended to cover the **Design** and **Written** tone, style and conventions used when creating or editing content for the SLQ Wiki. Dokuwiki plugins used in the SLQ Wiki are also covered.
Line 17: Line 15:
 The spread of audience and contributors  ranges from:  The spread of audience and contributors  ranges from: 
  
-  *  internal SLQ staff and volunteers +  *  internal State Library staff and volunteers 
-  *  external SLQ staff (not based at SLQ South Brisbane)+  *  external State Library (not based at South Brisbane)
   *  local and regional librarians   *  local and regional librarians
   *  local and regional councils   *  local and regional councils
Line 31: Line 29:
 ==== SLQ Wiki Content Types ===== ==== SLQ Wiki Content Types =====
  
- We've identified three types of SLQ Wiki content. **Ideas**, **Planning**, and **Releases**.  Tone and style may diverge from standard SLQ style for **Ideas** and **Planning**.+ We've identified three types of SLQ Wiki content. **Ideas**, **Planning**, and **Releases**.  Tone and style may diverge from standard State Library style for **Ideas** and **Planning**.
  
 ==== Ideas ==== ==== Ideas ====
Line 43: Line 41:
 ==== Planning ====  ==== Planning ==== 
  
-This covers engagement, product and process development, rationale exposition and broad scale planning. Once again tone can be informal, and will vary between authors - but more complex, academic, or domain specific language can be used.  At this point writers should be aware of the SLQ Style guide and should begin to formalise their style in line with this for pages that may be released.+This covers engagement, product and process development, rationale exposition and broad scale planning. Once again tone can be informal, and will vary between authors - but more complex, academic, or domain specific language can be used.  At this point writers should be aware of the State Library Style guide and should begin to formalise their style in line with this for pages that may be released.
  
 ==== Release  ===== ==== Release  =====
  
-This content is authoritative, polished and proofed. It is based on competent authority and reliable because it is coming from a person who is an expert or properly qualified.  The tone will be consistent throughout the work. Technical details will be finalised and up-to-date as required and the correct SLQ Style Guide should be followed.  This content includes finalised public workshops, pages about the SLQ wiki (like this one) and public talks give by SLQ staff. +This content is authoritative, polished and proofed. It is based on competent authority and reliable because it is coming from a person who is an expert or properly qualified.  The tone will be consistent throughout the work. Technical details will be finalised and up-to-date as required and the correct State Library Style Guide should be followed.  This content includes finalised public workshops, pages about the SLQ wiki (like this one) and public talks give by State Library staff.
  
-===== Applying the SLQ Style  =====+===== Applying the State Library Style  =====
  
-The SLQ Style Guides cover a broad range of communications. We should be applying them for all **Release** content, and be aware of them for all **Planning** content.+The State Library Style Guides cover a broad range of communications. We should be applying them for all **Release** content, and be aware of them for all **Planning** content.
  
 ==== Tone ==== ==== Tone ====
  
-The SLQ Style Guide effectively covers the tone required for the SLQ Wiki. <WRAP hideslide>Except in formal communication, SLQ’s tone of voice is informal, clear, direct and friendly, and audience-focussed.+The State Library Style Guide effectively covers the tone required for the SLQ Wiki. <WRAP hideslide>Except in formal communication, State Library ’s tone of voice is informal, clear, direct and friendly, and audience-focussed.
 </WRAP> </WRAP>
 ==== ==== ==== ====
Line 63: Line 61:
  
  
-Considering our audience/s and potential audiences helps to improve communication and to convey SLQ’s key messages effectively.  For example:+Considering our audience/s and potential audiences helps to improve communication and to convey State Library’s key messages effectively.  For example:
  
   * Old : State Library of Queensland provides access to collections.   * Old : State Library of Queensland provides access to collections.
Line 76: Line 74:
   * To emphasise positive relationships, use ‘you and us’ linking first and second person.    * To emphasise positive relationships, use ‘you and us’ linking first and second person. 
     * **Eg: We would love for you to contribute to the Flood and Cyclone Mosaic.**      * **Eg: We would love for you to contribute to the Flood and Cyclone Mosaic.** 
-  * To describe SLQ activities from an objective viewpoint, use third person (he, she, him, her, his, hers, they, them, theirs, it). This is also appropriate for formal communications.  +  * To describe State Library activities from an objective viewpoint, use third person (he, she, him, her, his, hers, they, them, theirs, it). This is also appropriate for formal communications.  
-    * **Eg: One of SLQ’s Indigenous Editors is Ellen van Neerven-Currie. She was also a finalist in the 2012 David Unaipon Award for her first novel.**+    * **Eg: One of State Library's Indigenous Editors is Ellen van Neerven-Currie. She was also a finalist in the 2012 David Unaipon Award for her first novel.**
  
- ==== Applying the SLQ Web Style ====+ ==== Applying the State Library Web Style ====
  
-While the basics of formatting your page are carried out by the Dokuwiki platform, the SLQ Web Style guide covers the key areas of content formatting that produce high quality conformant content. Once again, if you are working on **Releases** or **Planning** you should be aware of the SLQ Web Style. +While the basics of formatting your page are carried out by the Dokuwiki platform, the State Library Web Style guide covers the key areas of content formatting that produce high quality conformant content. Once again, if you are working on **Releases** or **Planning** you should be aware of the State Library Web Style. 
  
 ==== Page names/titles, web paths, headings and subheadings ==== ==== Page names/titles, web paths, headings and subheadings ====
Line 111: Line 109:
 ==== Numbering and bullets ==== ==== Numbering and bullets ====
  
-Avoid using a number series over more than one page. Remember users may be linked to a page anywhere in the wiki. Two styles are used by SLQ.+Avoid using a number series over more than one page. Remember users may be linked to a page anywhere in the wiki. Two styles are used by State Library.
  
 ==== ====  ==== ==== 
Line 134: Line 132:
   * enable diverse groups of clients to view and interact with innovative and creative multimedia presentations   * enable diverse groups of clients to view and interact with innovative and creative multimedia presentations
   * present interpretations of Queensland’s and Australia’s unique and diverse history and culture   * present interpretations of Queensland’s and Australia’s unique and diverse history and culture
-  * showcase SLQ’s diverse collection.+  * showcase State Library’s diverse collection.
  
  ===== Linking =====   ===== Linking ===== 

We acknowledge Aboriginal and Torres Strait Islander peoples and their continuing connection to land and as custodians of stories for millennia. We are inspired by this tradition in our work to share and preserve Queensland's memory for future generations.

© The State of Queensland (State Library of Queensland)