Difference between revisions of "Editorial/Style Guide"

From Kumu Wiki - TRU
Jump to navigation Jump to search
Line 49: Line 49:
  
 
== Glossary ==
 
== Glossary ==
Standardization
+
 
To ensure consistency, accuracy, and clarity, the following spelling and standardized terminology lists have been developed.
+
<big>Standardization</big>
Standardized TRU-OL Spelling List
+
<gallery>
acknowledgement
+
File:misspelled-words.jpg|Caption1
aging
+
</gallery>
anaesthetic
+
 
analyze
+
'''To ensure consistency, accuracy, and clarity, the following spelling and standardized terminology lists have been developed.'''
appendices
+
 
archaeology
+
<big>Standardized TRU-OL Spelling List</big>
audiovisual
+
 
axe
+
* acknowledgement
backup (n.)
+
* aging
behaviour
+
* anaesthetic
benefited
+
* analyze
biased
+
* appendices
birthdate
+
* archaeology
Blackboard
+
* audiovisual
Blackboard Collaborate (not Elluminate)
+
* axe
cacti
+
* backup (n.)
café
+
* behaviour
catalogue
+
* benefited
CD-ROM
+
* biased
cellphone
+
* birthdate
centimetre
+
* Blackboard
centre
+
* Blackboard Collaborate (not Elluminate)
cheque
+
* cacti
chlorophyll
+
* café
clamour
+
* catalogue
colour
+
* CD-ROM
co-operate
+
* cellphone
coordinate  
+
* centimetre
coordinator
+
* centre
counselled
+
* cheque
counsellor
+
* chlorophyll
Course Guide
+
* clamour
coursework
+
* colour
database
+
* co-operate
decision-making (attrib.)(adj.)
+
* coordinate  
decision making (n.)
+
* coordinator
defence
+
* counselled
demeanour
+
* counsellor
dialogue disc (sound or video)
+
* Course Guide
disk (computer)
+
* coursework
draft
+
* database
e-book
+
* decision-making (attrib.)(adj.)
email
+
* decision making (n.)
endeavour
+
* defence
enrol, enrolment
+
* demeanour
Enrolment Services
+
* dialogue disc (sound or video)
equalled
+
* disk (computer)
Exams Department
+
* draft
favour
+
* e-book
fetus
+
* email
fibre
+
* endeavour
focused
+
* enrol, enrolment
focuses (n. & v.)
+
* Enrolment Services
formulas
+
* equalled
fulfill
+
* Exams Department
fulfillment
+
* favour
grey
+
* fetus
Hhome Ppage (for our courses); home page
+
* fibre
honour
+
* focused
humour
+
* focuses (n. & v.)
icon
+
* formulas
imperilled
+
* fulfill
indexes
+
* fulfillment
instalment
+
* grey
instill
+
* Hhome Ppage (for our courses); home page
Internet
+
* honour
jewellery
+
* humour
journalling
+
* icon
judgment
+
* imperilled
kilometre  
+
* indexes
labelled
+
* instalment
left-hand
+
* instill
levelled licence (n.)
+
* Internet
license (v.)
+
* jewellery
lifestyle
+
* journalling
likeable
+
* judgment
livable
+
* kilometre  
long-term (attrib.)
+
* labelled
lustre
+
* left-hand
manoeuvre
+
* levelled licence (n.)
marvellous
+
* license (v.)
meagre
+
* lifestyle
medieval
+
* likeable
meter (instrument)
+
* livable
Metis
+
* long-term (attrib.)
metre (measurement)
+
* lustre
midterm
+
* manoeuvre
modelled, modelling  
+
* marvellous
mould
+
* meagre
naive, naïveté
+
* medieval
neighbour
+
* meter (instrument)
Net (Internet)
+
* Metis
odour
+
* metre (measurement)
offence
+
* midterm
online (adj. & adv.)  
+
* modelled, modelling  
Open Learning Faculty Member (not OLFM)
+
* mould
organize
+
* naive, naïveté
paralleled
+
* neighbour
paralyze
+
* Net (Internet)
per cent
+
* odour
plow (n. & v.)
+
* offence
postwar
+
* online (adj. & adv.)  
practice (n.)
+
* Open Learning Faculty Member (not OLFM)
practise (v.)
+
* organize
practice exam pretense
+
* paralleled
program
+
* paralyze
prophecy (n.)
+
* per cent
prophesy (v.)
+
* plow (n. & v.)
realize
+
* postwar
recognize
+
* practice (n.)
regroup
+
* practise (v.)
revisit
+
* practice exam pretense
savour  
+
* program
self-test
+
* prophecy (n.)
short-term ((attrib.)
+
* prophesy (v.)
signalled
+
* realize
sizable
+
* recognize
skilful
+
* regroup
smoulder
+
* revisit
sombre
+
* savour  
spectre
+
* self-test
storey (building)
+
* short-term ((attrib.)
Student Handbook
+
* signalled
sulphur
+
* sizable
theatre
+
* skilful
toward
+
* smoulder
tranquilize
+
* sombre
tranquilizer
+
* spectre
travelled
+
* storey (building)
traveller
+
* Student Handbook
TRU-OL (use hyphen)
+
* sulphur
TRU-OL, Open Learning
+
* theatre
tumour
+
* toward
usable
+
* tranquilize
videoclip
+
* tranquilizer
videotape
+
* travelled
vigour  
+
* traveller
web (Internet)  
+
* TRU-OL (use hyphen)
web browser
+
* TRU-OL, Open Learning
web page  
+
* tumour
website
+
* usable
 +
* videoclip
 +
* videotape
 +
* vigour  
 +
* web (Internet)  
 +
* web browser
 +
* web page  
 +
* website
 +
 
 
This list conforms to The Canadian Oxford Dictionary, (2004), which we follow unless the a course project team decides on alternativestakes an alternate approach—, for example, to be consistent with the main textbook used for a course.  
 
This list conforms to The Canadian Oxford Dictionary, (2004), which we follow unless the a course project team decides on alternativestakes an alternate approach—, for example, to be consistent with the main textbook used for a course.  
 
   
 
   
Standardized Terminology
+
<big>Standardized Terminology</big>
“Assignments” (for the link in the LMS, not Assignment File)
+
 
click (not “click on” or “clink on”)
+
* “Assignments” (for the link in the LMS, not Assignment File)
Course Modules OR Course Units (but not both)
+
* click (not “click on” or “clink on”)
Course Guide (not Course Overview OR Course Manual (but not both)
+
* Course Modules OR Course Units (but not both)
Course Tools menu (not Course Menu area)
+
* Course Guide (not Course Overview OR Course Manual (but not both)
“Discussions” (not forum, area, board, or conference)
+
* Course Tools menu (not Course Menu area)
Distance Regional & Open Learning (DROL) Services (and no quotation marks, no hyphen after Regional)
+
* “Discussions” (not forum, area, board, or conference)
“Following a citation trail” guide (as the title of the guide itself, not the link)
+
* Distance Regional & Open Learning (DROL) Services (and no quotation marks, no hyphen after Regional)
“Getting Started” (not “Getting Started with WebCT Guide”)
+
* “Following a citation trail” guide (as the title of the guide itself, not the link)
“Help” link or “Help” (not HELP button)
+
* “Getting Started” (not “Getting Started with WebCT Guide”)
home page (two words, lowercase unless referring to course Home Page)
+
* “Help” link or “Help” (not HELP button)
How Do I...? (Do is first-initial cap; question mark goes after ellipses)
+
* home page (two words, lowercase unless referring to course Home Page)
IT Service Desk (not Help Desk, not IT service desk)
+
* How Do I...? (Do is first-initial cap; question mark goes after ellipses)
learning management system (not WebCT)
+
* IT Service Desk (not Help Desk, not IT service desk)
Library (when TRU Library) (not TRU-OL library)
+
* learning management system (not WebCT)
“Mail” tool (instead of “mail in WebCT”)
+
* Library (when TRU Library) (not TRU-OL library)
Pack Slip (not Packing Grid)
+
* “Mail” tool (instead of “mail in WebCT”)
PIN (not PIN number)  
+
* Pack Slip (not Packing Grid)
Student Handbook
+
* PIN (not PIN number)  
TRU Library (not the TRU Library)
+
* Student Handbook
TRU-OL Social Sciences Guide
+
* TRU Library (not the TRU Library)
TRU Open Learning
+
* TRU-OL Social Sciences Guide
Tutor Open Learning Faculty Member (not OLFM, Tutor, Facilitator, or Instructor)
+
* TRU Open Learning
Tutor Marked Assignment form
+
* Tutor Open Learning Faculty Member (not OLFM, Tutor, Facilitator, or Instructor)
“View Attempt” not view results
+
* Tutor Marked Assignment form
“Web Links”
+
* “View Attempt” not view results
welcome letter  (lowercase)
+
* “Web Links”
World Wide Web, but web
+
* welcome letter  (lowercase)
Other:
+
* World Wide Web, but web
“Getting Connected to WebCT” is outdated (get rid of WebCT references)  
+
* Other:
There is no “WebCT Guide”
+
* “Getting Connected to WebCT” is outdated (get rid of WebCT references)  
Italics for course names (after acronym and number)
+
* There is no “WebCT Guide”
Print info not needed, how to access course online info not needed
+
* Italics for course names (after acronym and number)
Think in terms of students viewing the info on a monitor: for example, change language such as “turn now to your Assignments File”
+
* Print info not needed, how to access course online info not needed
Recommendations:
+
* Think in terms of students viewing the info on a monitor: for example, change language such as “turn now to your Assignments File”
 +
 
 +
<big>Recommendations:</big>
 +
 
 
Include, on the “Web Links” page, a link to TRU-OL Examinations (so students can plan)
 
Include, on the “Web Links” page, a link to TRU-OL Examinations (so students can plan)
 
Include, on the “Web Links” page, a link to Submission Guidelines, as it is referred to constantly in some courses
 
Include, on the “Web Links” page, a link to Submission Guidelines, as it is referred to constantly in some courses

Revision as of 12:15, 14 January 2014

Potential Sections for In-House Editorial Style Guide (TRU-OL)

What Is a Style Guide? (Purpose Statement)

  • What is a Style Guide? How to use a style guide? Who should use this style guide? Benefits of using a style guide?
  • How does this support the TRU Academic Plan

Structure of TRU-OL Courses

TRU-OL courses come in many shapes and varieties, which we call methods of delivery.

  • Distinction between modalities and delivery modes

Reference Style Guides

Other Resources

  • Standardized Course Guide

Writing Conventions

The original plan had file naming conventions under writing conventions, but I suggest we make a new section for file naming (below).

File Naming Conventions

We use file naming conventions in Curriculum Services for syntactical consistency, which in turn supports file management and helps Production to identify how files should be organized. [Could we express this more clearly using plain English?]

How to name TRU-OL files

Guidelines for Typography/Page Design/PowerPoint

  • Sample hierarchy of headings
  • Sample title page

Copyright Guidelines

New policy 02/04/2013: New online copyright clearing form: http://kamino.tru.ca/ipo/register.html The results come directly to IPO team care of the copyright@tru.ca e-mail. This should eliminate the need for filling out other forms.

Editing Best Practices and Style Checklists

  • Media
  • Math type and eq. editor
  • Styles in MS Word
  • Templates
  • Show changes: How to do it? What to keep in show changes & what to accept?
  • Deep links & URLs: link from anchor text and/or provide written URL?
  • Publisher's online materials: computer requirements, open access mandate, log-in instructions, privacy concerns (if any)

Glossary

Standardization

To ensure consistency, accuracy, and clarity, the following spelling and standardized terminology lists have been developed.

Standardized TRU-OL Spelling List

  • acknowledgement
  • aging
  • anaesthetic
  • analyze
  • appendices
  • archaeology
  • audiovisual
  • axe
  • backup (n.)
  • behaviour
  • benefited
  • biased
  • birthdate
  • Blackboard
  • Blackboard Collaborate (not Elluminate)
  • cacti
  • café
  • catalogue
  • CD-ROM
  • cellphone
  • centimetre
  • centre
  • cheque
  • chlorophyll
  • clamour
  • colour
  • co-operate
  • coordinate
  • coordinator
  • counselled
  • counsellor
  • Course Guide
  • coursework
  • database
  • decision-making (attrib.)(adj.)
  • decision making (n.)
  • defence
  • demeanour
  • dialogue disc (sound or video)
  • disk (computer)
  • draft
  • e-book
  • email
  • endeavour
  • enrol, enrolment
  • Enrolment Services
  • equalled
  • Exams Department
  • favour
  • fetus
  • fibre
  • focused
  • focuses (n. & v.)
  • formulas
  • fulfill
  • fulfillment
  • grey
  • Hhome Ppage (for our courses); home page
  • honour
  • humour
  • icon
  • imperilled
  • indexes
  • instalment
  • instill
  • Internet
  • jewellery
  • journalling
  • judgment
  • kilometre
  • labelled
  • left-hand
  • levelled licence (n.)
  • license (v.)
  • lifestyle
  • likeable
  • livable
  • long-term (attrib.)
  • lustre
  • manoeuvre
  • marvellous
  • meagre
  • medieval
  • meter (instrument)
  • Metis
  • metre (measurement)
  • midterm
  • modelled, modelling
  • mould
  • naive, naïveté
  • neighbour
  • Net (Internet)
  • odour
  • offence
  • online (adj. & adv.)
  • Open Learning Faculty Member (not OLFM)
  • organize
  • paralleled
  • paralyze
  • per cent
  • plow (n. & v.)
  • postwar
  • practice (n.)
  • practise (v.)
  • practice exam pretense
  • program
  • prophecy (n.)
  • prophesy (v.)
  • realize
  • recognize
  • regroup
  • revisit
  • savour
  • self-test
  • short-term ((attrib.)
  • signalled
  • sizable
  • skilful
  • smoulder
  • sombre
  • spectre
  • storey (building)
  • Student Handbook
  • sulphur
  • theatre
  • toward
  • tranquilize
  • tranquilizer
  • travelled
  • traveller
  • TRU-OL (use hyphen)
  • TRU-OL, Open Learning
  • tumour
  • usable
  • videoclip
  • videotape
  • vigour
  • web (Internet)
  • web browser
  • web page
  • website

This list conforms to The Canadian Oxford Dictionary, (2004), which we follow unless the a course project team decides on alternativestakes an alternate approach—, for example, to be consistent with the main textbook used for a course.

Standardized Terminology

  • “Assignments” (for the link in the LMS, not Assignment File)
  • click (not “click on” or “clink on”)
  • Course Modules OR Course Units (but not both)
  • Course Guide (not Course Overview OR Course Manual (but not both)
  • Course Tools menu (not Course Menu area)
  • “Discussions” (not forum, area, board, or conference)
  • Distance Regional & Open Learning (DROL) Services (and no quotation marks, no hyphen after Regional)
  • “Following a citation trail” guide (as the title of the guide itself, not the link)
  • “Getting Started” (not “Getting Started with WebCT Guide”)
  • “Help” link or “Help” (not HELP button)
  • home page (two words, lowercase unless referring to course Home Page)
  • How Do I...? (Do is first-initial cap; question mark goes after ellipses)
  • IT Service Desk (not Help Desk, not IT service desk)
  • learning management system (not WebCT)
  • Library (when TRU Library) (not TRU-OL library)
  • “Mail” tool (instead of “mail in WebCT”)
  • Pack Slip (not Packing Grid)
  • PIN (not PIN number)
  • Student Handbook
  • TRU Library (not the TRU Library)
  • TRU-OL Social Sciences Guide
  • TRU Open Learning
  • Tutor Open Learning Faculty Member (not OLFM, Tutor, Facilitator, or Instructor)
  • Tutor Marked Assignment form
  • “View Attempt” not view results
  • “Web Links”
  • welcome letter (lowercase)
  • World Wide Web, but web
  • Other:
  • “Getting Connected to WebCT” is outdated (get rid of WebCT references)
  • There is no “WebCT Guide”
  • Italics for course names (after acronym and number)
  • Print info not needed, how to access course online info not needed
  • Think in terms of students viewing the info on a monitor: for example, change language such as “turn now to your Assignments File”

Recommendations:

Include, on the “Web Links” page, a link to TRU-OL Examinations (so students can plan) Include, on the “Web Links” page, a link to Submission Guidelines, as it is referred to constantly in some courses Include, on the “Web Links” page, a link to Grading Systems and Procedures Fix language in grading scale: for example, Grading Systems and Policies is called Grading Systems and Procedures on the TRU web page

Appendix A: TRU-OL Course Formats Information

  • Note: Please see the discussion topic on presenting the appendix info in a wiki or web context.

Appendix B: Editorial Projects Information

Appendix C: Forms

Links to:

  • IP form
  • Media web site
  • CIS (?)

Appendix D: Overview of TRU Open Learning

Thompson Rivers University, Open Learning (TRU-OL) is the Division of Thompson Rivers University (TRU) that specializes in providing learners with flexible learning options, open access to education wherever possible, and a wide variety of course and program choices, meeting the needs of its own students and helping other institutions and organizations meet the open and online learning needs of their communities.

TRU is a public institution mandated by the provincial government to provide the province's open learning programming and an open learning educational credit bank, TRU-OL opens the door to accessible, recognized and quality post-secondary education, providing learning opportunities in print, online, web-based or blended formats, with programs tailored to each student's personal needs and support offered by over 160 highly respected and qualified Open Learning Faculty Members from all over BC.

For a comprehensive description of TRU, Open Learning Division (TRU-OL), see About TRU Open Learning

Appendix E: TRU Policies

TRU Editing Style Checklist

Purpose Statement

Reference Style Guides and Other Resources

Writing Conventions

Copyright Forms and Guidelines

Media Forms and Files

Glossary

Interculturalizing the Curriculum Resources

Standardized Course Guide Resources

Best Practices