Difference between revisions of "Best Practices"

From Kumu Wiki - TRU
Jump to navigation Jump to search
Line 7: Line 7:
 
* Scope of edit: this may change as editing proceeds and may differ from information captured in JIRA
 
* Scope of edit: this may change as editing proceeds and may differ from information captured in JIRA
 
* How to handle URLs: for example, as weblinks with author/originator stated, title of resource in bold font, URL provided, instructions to Production
 
* How to handle URLs: for example, as weblinks with author/originator stated, title of resource in bold font, URL provided, instructions to Production
* Citation style to be used
+
* What citation style is to be used
 
*  
 
*  
 
Verify with the curriculum assistant the following:
 
Verify with the curriculum assistant the following:
Line 15: Line 15:
 
* Either set up a new style sheet or get one from the previous editor
 
* Either set up a new style sheet or get one from the previous editor
 
* Log in to Blackboard Learn[link] and note in the style sheet choices already made for the course
 
* Log in to Blackboard Learn[link] and note in the style sheet choices already made for the course
 +
 +
== During Edit [this heading will change] ==
 +
=== Use JIRA ===
 +
# Log work. If there are two MODs (methods of delivery), log work under each one.
 +
# Enter comments for top-level information (from which an editing memo can be made) on the main page.
 +
# Enter comments for granular information under the log work page.

Revision as of 12:28, 14 January 2014

Best Practices for Editing TRU-OL Curriculum Materials

[for checklists: expand each item in the list to link to subpage]

Conduct a Pre-Edit

Confirm with Brian (editing co-ordinator) the following:

  • Issue (course) has been entered in JIRA[link] and assigned

Discuss and verify with the instructional designer, course lead, SME, or course writer the following:

  • Scope of edit: this may change as editing proceeds and may differ from information captured in JIRA
  • How to handle URLs: for example, as weblinks with author/originator stated, title of resource in bold font, URL provided, instructions to Production
  • What citation style is to be used

Verify with the curriculum assistant the following:

  • Details of the textbook(s) (name, author, edition); companion website; and other resources
  • Editor's access to the resources

Set up a style sheet:

  • Either set up a new style sheet or get one from the previous editor
  • Log in to Blackboard Learn[link] and note in the style sheet choices already made for the course

During Edit [this heading will change]

Use JIRA

  1. Log work. If there are two MODs (methods of delivery), log work under each one.
  2. Enter comments for top-level information (from which an editing memo can be made) on the main page.
  3. Enter comments for granular information under the log work page.