Create some documentation - both Blackboard and github

[djplaner]

• [ ] Improve readme using these guidelines
• [x] Design structure for documentation in Blackboard (L@G) - make them independent
• [x] Write the matcing Word documents
• [x] Experiment with Mammoth produced HTML going into repo /docs and publish with github pages
• [x] Have separate splash pages for github, blackboard etc.
• [x] Design some CSS for github?

mkdocs tasks

• [ ] Figure out how to handle embed style when converting for github/mkdocs
• [x] What type of "note" style can be implemented?? Actually just look at include the study css in the file and that might work

Content fixes

• [x] What and why
  • [x] rewrite the intro and figure out better structure
• [x] How does it work
  • [ ] Manual method for conversion needs to be written
  • [ ] Figure captions are broken
• [ ] Using / Set up
  • [x] italics and bold in Set up
  • [ ] some broken figure cross reference
• [ ] Using / Create and modify
  • [x] italics and bold
  • [ ] some broken figure cross reference
• [ ] Creating / Textual
  • [ ] broken figure cross referencing
• [ ] Creating / Web
  • [x] Figure 1 is not floating right with caption properly
  • [x] partly because missing
    
• [ ] Creating / University
  • [ ] Film Watch Options not working as the Javascript isn't running (Maybe link to styles as well)
• [x] Customising / Accordion opening
  • [x] embed style not embedding - is this Javascript/CSS issues. Is this working in the Card docs?

[djplaner]

Documentation content

Something at the top about content including both activities and contenet??

Background

Why would you use the Content Interface? What can it do? How does it work?

• Design gallery - new
• What and why
  • First few sections of current content
• How it works - the How do you use it section
  • Introduce the page components

Using the Content Interface

What steps are involved in using the Content Interface?

• Set up a Content Interface page
  • include linking to shared file
• Create and modify content
  • Aim here is to show the high level steps: create some folders, copy the template document (maybe use themes). Set it up on shared drive
• Upating a Content Interface page Not sure about this one yet
• Connecting to shared folder this is separate from content interface

Creating content - task based

What types of content can I create? How?

How do I (each of these sub-sections could have - How do I - as the lede)

• Use normal textual content - headings, texts, quotes...
• Use web content - images, links, video, embeddable content
• Use University content and activities - readings, activities, notes, University dates...
• Use Blackboard functionality - content items, adaptive release, review status, menu items

Customising content

How do I change how the Content Interface looks and how it works

• customise the appearance of the accordions
• customise the appearance of the page content
• customise which accordion opens first