Further fixes to formatting etc.

IET-OU · Feb 27, 2019 · d72d42a · d72d42a
1 parent 6637822
commit d72d42a
Show file tree

Hide file tree

Showing 9 changed files with 647 additions and 47 deletions.
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -27,7 +27,10 @@ CompendiumLD version 1.13 released for Windows, Mac and Linux | _2011-03-04 09:2
 
 CompendiumLD version 1.0 released for Windows, Mac and Linux | _2010-05-05 16:55:37 BST_.
 
-*   Export of XML files conforming to the standard Compendium DTD enabled via the ‘Export to XML option’. Un-tick the ‘Include learning design timing data’ to export a standard Compendium XML file which can be imported into other versions of [Compendium](http://compendium.open.ac.uk/). These files will not include learning design timing information.
+*   Export of XML files conforming to the standard Compendium DTD enabled via the ‘_Export to XML option_’.
+  Un-tick the ‘_Include learning design timing data_’ to export a standard Compendium XML file
+  which can be imported into other versions of [Compendium](http://compendium.open.ac.uk/).
+  These files will not include learning design timing information.
 *   ‘How do I get started with CompendiumLD?’ map edited so that it links to HTML tutorials rather than pdfs.
 
 </div>
@@ -38,7 +41,11 @@ CompendiumLD version 1.0 released for Windows, Mac and Linux | _2010-05-05 16:55
 
 CompendiumLD version 0.98 released for Windows, Mac and Linux | _2010-03-26 17:21:22 GMT_.
 
-*   Learning design stencil edited and reduced to a set of four stencils: `LD-OU` (core learning design stencil), `LD-CONDITIONA` (to add conditions and different pathways to a learning design), Sequence mapping (a stencil to help with laying out of learning activities), Approaches to LD (examples of approaches to learning design, each map shows a different approach to the design process)
+*   Learning design stencil edited and reduced to a set of four stencils:
+  `LD-OU` (_core learning design stencil_),
+  `LD-CONDITIONAL` (_to add conditions and different pathways to a learning design_),
+  Sequence mapping (_a stencil to help with laying out of learning activities_),
+  Approaches to LD (_examples of approaches to learning design, each map shows a different approach to the design process_)
 *   Bug in new link drawing code fixed: export as JPEG and HTML now works correctly.
 *   Bug fixed in show/hide task times (called via menu option)
 *   Help menu changed to refer to online help movies page
@@ -53,11 +60,13 @@ CompendiumLD v0.95 for Windows and Mac released | _2010-03-26 17:21:22 GMT_.
 
 *   New learning design node icons introduced for the activity, conditional and task sequence/swim-lane stencils
 *   Link drawing improved: links now start and stop very close to the node icons, and move around node indicators (e.g. the label, weight, timing, detail and [transclusion][] indicators).
-*   Activity and task timing information is not shown by default. Now need to right click in an activity and select 'Show task times' to display it.
-*   New welcome map introduced ‘How do I get started with CompendiumLD?’
+*   Activity and task timing information is not shown by default. Now need to right click in an activity and select '_Show task times_' to display it.
+*   New welcome map introduced ‘_How do I get started with CompendiumLD?_’
 *   When projects are created, the nominated user is made the default user
 *   LD help – activities found now created transclusions of existing activities
-*   Small icon display fixed. To show a small icon for an individual node, select the node and click the button on the node format toolbar. To create small icons by default select the menu option :Tools->Project Options->Node Extras ->'Use small icon'. Note that once you select this option, small icons will be created until you deselect it.
+*   Small icon display fixed. To show a small icon for an individual node, select the node and click the button on the node format toolbar.
+  To create small icons by default select the menu option: _Tools->Project Options->Node Extras ->'Use small icon'_.
+  Note that once you select this option, small icons will be created until you deselect it.
 *   Change learning design node type menu introduced.
 *   Paste and paste special menu options introduced – copying and pasting works similarly to other applications, except for activity nodes.
 *   Menus changed so that menu options used less frequently by most users are hidden by default

diff --git a/docs/CREDITS.md b/docs/CREDITS.md
@@ -3,7 +3,7 @@ Source :~ <http://www.open.ac.uk/blogs/OULDI/?page_id=37>
 
 # The Team
 
-![Rebecca](http://www.open.ac.uk/blogs/OULDI/wp-content/uploads/2010/11/Rebecca.jpg "Rebecca")](https://twitter.com/rebeccagalley)
+[![Rebecca](http://www.open.ac.uk/blogs/OULDI/wp-content/uploads/2010/11/Rebecca.jpg "Rebecca")](https://twitter.com/rebeccagalley)
 
 **Rebecca Galley**, Curriculum Design Project Officer / Project Research
 
@@ -31,7 +31,7 @@ Source :~ <http://www.open.ac.uk/blogs/OULDI/?page_id=37>
 **Andrew Brasher**, Lead developer (CompendiumLD)
 
 
-![Paul](http://www.open.ac.uk/blogs/OULDI/wp-content/uploads/2010/11/Paul.jpg "Paul")
+[![Paul](http://www.open.ac.uk/blogs/OULDI/wp-content/uploads/2010/11/Paul.jpg "Paul")][paul]
 
 **Paul Mundin**, Learning and Teaching Development Officer
 
@@ -66,6 +66,7 @@ on which _Gráinne Conole_ was critical friend and it is expected that this work
 In addition we have been working with the LAMS group and are looking forward to continuing to work with Gráinne and her new team at Leicester University.
 
 [archive]: https://web.archive.org/web/20180705125508/http://www.open.ac.uk/blogs/OULDI/?page_id=37
+[paul]: https://cloudworks.ac.uk/user/view/798 "Paul Mundin, on Cloudworks"
 [ouldi-jisc]: https://web.archive.org/web/20141209211813/http://jisc.ac.uk/whatwedo/programmes/elearning/curriculumdesign/ouldi.aspx
   "Open University learning design initiative project (JISC-OULDI), on Archive.org"
 [reading university]: http://www.open.ac.uk/blogs/OULDI/?page_id=277

diff --git a/docs/documentation.md b/docs/documentation.md
@@ -5,7 +5,7 @@ Source :~ <http://compendiumld.open.ac.uk/documentation/>
 
 If you are new to CompendiumLD and want to find out how to use it, one or more of the the items under '[Using CompendiumLD](#using)' should help. If you want to share your CompendiumLD designs across different computers, or with other people, there are some suggestions about [ways to achieve this](#collaborateshare "Collaborating and sharing with CompendiumLD"). If you would like to help to improve CompendiumLD you can, by submitting [bug reports or feature requests](#improve "Improving CompendiumLD"), for example.
 
-### <a name="using" id="using"></a> Using CompendiumLD
+### <a name="using" ></a>Using CompendiumLD
 
 *   A 2 page summary of the aims and functionality of CompendiumLD is presented in this [CompendiumLD Briefing paper](../documentation/version1.0/QuickRefGuides/CompendiumLD-briefing-paper.pdf)
 *   [Getting started](../gettingstarted.html) is a quick introduction which describes how to install CompendiumLD and what to do when you run it for the first time. It includes a slide show and some video illustrating CompendiumLD's operation. If you need a more detailed step-by-step guide please refer to these [tutorials](../documentation/version1.0/tutorials/) introducing CompendiumLD. .
@@ -14,24 +14,29 @@ If you are new to CompendiumLD and want to find out how to use it, one or more o
 *   A [guide to the nodes and stencils](../documentation/version1.0/QuickRefGuides/stencilsAndNodes/) for designing learning activities with CompendiumLD
 *   [Examples of learning designs created using CompendiumLD](../documentation/examples)
 
-### <a name="collaborateshare" id="collaborateshare"></a> Collaborating and sharing with CompendiumLD
+### <a name="collaborateshare" ></a>Collaborating and sharing with CompendiumLD
 
 Here are some suggestions of ways you can share your CompendiumLD data across different computers, and with other people.
 
 *   If you use more than one computer you can use a utility such as [Dropbox](https://www.dropbox.com/) to share and synchronise your CompendiumLD data across multiple machines. Other cloud based data sharing services are available in addition to Dropbox!
 *   You can share an image and/or the XML data of your learning design via [Cloudworks][] (a place to share, find and discuss learning and teaching ideas and experiences).
-*   There is a <span class="warning">prototype</span> web site for publishing and sharing CompendiumLD and Compendium maps. This [CompendiumLD map exchange](http://compendium.open.ac.uk/moodle/course/view.php?id=7) area of the Compendium map exchange allows users to upload their own maps and download others. All maps are published and shared using the [Creative Commons Attribution-NonCommercial-ShareAlike 2.0 Licence](https://creativecommons.org/licenses/by-nc-sa/2.0/uk/).
+*   There is a __prototype__ web site for publishing and sharing CompendiumLD and Compendium maps.
+  This [CompendiumLD map exchange][moodle] area of the Compendium map exchange allows users to upload their own maps and download others.
+  All maps are published and shared using the [Creative Commons Attribution-NonCommercial-ShareAlike 2.0 Licence][cc-by-nc-sa].
 
-### <a name="improve" id="improve"></a> Improving CompendiumLD
+### <a name="improve" ></a>Improving CompendiumLD
 
 It helps us to improve CompendiumLD if users report bugs, and requests for features helps us prioritise aspects of work on CompendiumLD.
 
-*   [Bug Reports / Feature Requests](http://compendium.open.ac.uk/bugzilla/enter_bug.cgi?product=CompendiumLD).
+*   [Bug Reports / Feature Requests][bugz-arch].
     This link takes you to the Compendium feature request and bug tracking site. If you have not already done so you will need to create an account to submit or browse through reported bugs and/or feature requests.
 *   [How to translate CompendiumLD into other languages](../documentation/translation/)
 
 [archive]: https://web.archive.org/web/20180401065418/http://compendiumld.open.ac.uk/documentation/
-[arch-bugz]: https://web.archive.org/web/20160902233719/http://compendium.open.ac.uk/bugzilla/enter_bug.cgi?product=CompendiumLD
+[bugz]: http://compendium.open.ac.uk/bugzilla/enter_bug.cgi?product=CompendiumLD
+[bugz-arch]: https://web.archive.org/web/20160902233719/http://compendium.open.ac.uk/bugzilla/enter_bug.cgi?product=CompendiumLD
 [cloudworks]: https://cloudworks.ac.uk/cloud/view/3687
+[moodle]: http://compendium.open.ac.uk/moodle/course/view.php?id=7 "404 Not Found"
+[cc-by-nc-sa]: https://creativecommons.org/licenses/by-nc-sa/2.0/uk/
 
 ---
diff --git a/docs/examples.md b/docs/examples.md
@@ -5,13 +5,25 @@ Source :~ <http://compendiumld.open.ac.uk/documentation/examples/>
 
 Here are several examples of designs created using CompendiumLD. These show a few different ways the tool can be used to visualise activities and related information.
 
-*   [![](middle-east-role-play/middle-ast-role-play.png)](./middle-east-role-play) An [activity for teaching students about the politics of the Middle East using role play](./middle-east-role-play). This example has been created using the export 'Web Maps" option, available via the 'File' menu in CompendiumLD i.e. 'File->Export->Web Maps'. It shows some background information about the use of simulations and role playing in teaching, as well as the learning activity itself. It uses nodes from the core learning design stencil, and the clock timing indicator from the sequence mapping stencil.
-
-    This learning activity is based on a paper written in 1998 ([Vincent, A. and Shepherd, J. (1998)](http://jime.open.ac.uk/98/11/vincent-98-11-paper.html)). You can download the source file and try modifying it to use more recent internet technologies. _To edit or extend this design, save this [role play activity file](middle-east-role-play/middle-east-role-play-v098.zip) to your computer, then load it into CompendiumLD using the 'File->Import->Learning design file..' option to import the .zip file._
-
-*   [![](activity-theory/activity-theory-template.png)](activity-theory/activity-theory-template.svg) An [Activity Theory Template](activity-theory/activity-theory-template.svg) is available within CompendiumLD. This is intended to be a starting point for modelling and analysing existing learning designs from an activity theory viewpoint. For a background to using activity theory to analyse educational interactions, see e.g. [Issroff, K., & Scanlon, E. (2002). Using technology in Higher Education: an Activity Theory perspective. Journal of Computer Assisted Learning, 18(1), 77-83](http://oro.open.ac.uk/964/). This example has been created using the export '[SVG](http://www.w3.org/Graphics/SVG/)' option, available via the 'File/Save' menu in CompendiumLD i.e. 'File->Export/Save->SVG'.  
-
-*   [![](analytical-skills+theory/peer-assessment-sm.png)](analytical-skills+theory) [Peer assessment using a wiki](analytical-skills+theory): this design uses a wiki to involve students in exploration of a theory, reflect on how it might impact on their current practice, and to analyse others' ideas on the same topic using a process of peer assessment. It could be used in applied disciplines e.g. business/management, or health and social care. This is a prototype of a design, i.e. the design is not fully developed. It is intended as a prompt for others to build on and make specific to their needs.
+*   [![Middle East role play](middle-east-role-play/middle-ast-role-play.png)](./middle-east-role-play) An [activity for teaching students about the politics of the Middle East using role play](./middle-east-role-play).
+  This example has been created using the export 'Web Maps" option, available via the 'File' menu in CompendiumLD i.e. 'File->Export->Web Maps'.
+  It shows some background information about the use of simulations and role playing in teaching, as well as the learning activity itself.
+  It uses nodes from the core learning design stencil, and the clock timing indicator from the sequence mapping stencil.
+
+  This learning activity is based on a paper written in 1998 ([Vincent, A. and Shepherd, J. (1998)][vincent]).
+  You can download the source file and try modifying it to use more recent internet technologies.
+  _To edit or extend this design, save this [role play activity file](middle-east-role-play/middle-east-role-play-v098.zip)
+  to your computer, then load it into CompendiumLD using the 'File->Import->Learning design file..' option to import the .zip file._
+
+*   [![Activity theory template](activity-theory/activity-theory-template.png)](activity-theory/activity-theory-template.svg) An [Activity Theory Template](activity-theory/activity-theory-template.svg) is available within CompendiumLD.
+  This is intended to be a starting point for modelling and analysing existing learning designs from an activity theory viewpoint.
+  For a background to using activity theory to analyse educational interactions, see e.g.
+  [Issroff, K., & Scanlon, E. (2002). Using technology in Higher Education: an Activity Theory perspective. Journal of Computer Assisted Learning, 18(1), 77-83][issroff].
+  This example has been created using the export '[SVG][]' option, available via the 'File/Save' menu in CompendiumLD i.e. 'File->Export/Save->SVG'.  
+
+*   [![Peer assessment](analytical-skills+theory/peer-assessment-sm.png)](analytical-skills+theory) [Peer assessment using a wiki](analytical-skills+theory): this design uses a wiki to involve students in exploration of a theory, reflect on how it might impact on their current practice, and to analyse others' ideas on the same topic using a process of peer assessment.
+  It could be used in applied disciplines e.g. business/management, or health and social care.
+  This is a prototype of a design, i.e. the design is not fully developed. It is intended as a prompt for others to build on and make specific to their needs.
 
     _To edit or extend this design, save this [activity file](analytical-skills+theory/analytical-skills+theory.zip) to your computer, then load it into CompendiumLD using the 'File->Import/Open->Learning design file..' option to import the .zip file._
 
@@ -24,5 +36,11 @@ Here are several examples of designs created using CompendiumLD. These show a fe
 *   [Tutorial examples](./tutorial-examples/) is a list of the examples referred to in the [CompendiumLD tutorials](../../documentation/version1.0/tutorials/).
 
 [archive]: https://web.archive.org/web/20181229083853/http://compendiumld.open.ac.uk/documentation/examples/
+[vinc-old]: http://jime.open.ac.uk/98/11/vincent-98-11-paper.html
+[vincent]: https://jime.open.ac.uk/articles/10.5334/1998-11/
+  "incent, A. and Shepherd, J., 1998. Experiences in Teaching Middle East Politics via Internet-based Role-Play Simulation. Journal of Interactive Media in Education, 1998(3), p.Art. 11. DOI: http://doi.org/10.5334/1998-11"
+[issroff]: https://oro.open.ac.uk/964/
+  "Issroff, K. and Scanlon, E. (2002). Using technology in Higher Education: an activity theory perspective. Journal of Computer Assisted Learning, 18(1) pp. 77–83."
+[svg]: https://www.w3.org/Graphics/SVG/ "Scalable Vector Graphics (SVG)"
 
 ---