rethink rest of documentation structure

[djplaner]

Rejig of home page (#261) refines some structure, could inform a rethink of the structure of the rest of the documentation.

Away from

• Getting Started
• How-Tos
• Reference
• Community
• About

Current progress - configure claytons - probably needs a full break up of this page into a process section like live collections. Possibly some changed in title (steps to ...?)

[djplaner]

New design possibilities?

Getting Started

Purpose - get people up and going wtih Collections. largely installation, but maybe still collections 101?

Changes?

• Maybe just refine the getting started overview page into a "What now?" type page.
• Remove mention of Claytons from the building blocks/four concepts - move it into interface
• Maybe 101 becomes point back to the home page

Questions folk might like to answer

• Is it already installed? How do I install it?

Getting Started

• Where to now? - Learn more OR install
  • First, Learn more about Canvas Modules - bit from Collections 101 overview
  • Options from here
    • Learn more - see learn more below
    • Start using - Install (below) and then configure/navigate
• Install
  • Is it already installed? -- adapt/integrate is it working
  • Installing Collections (old types and pre-requisites)
  • Individidual
  • Institutional
• Learn more (replace Collections 101)
  • More about Collections
    • Watch (the video)
    • Read (the current stuff)
  • Concepts (current page updated)
  • Interface
    • Navigation
    • Configuration

Configuring

Remove how-tos and move those sections into configuring and navigating

Configuring would take "add collections to a course"

Configuring

• Configuring Collections (overview page)
  • adapt some of the current overview page from how-to. Reduce the pre-cursor. Give overview
  • separate out the steps - before & after isn't a step. More linked to the example

Navigating

Take the navigate Collections sections from how-tos

• [x] Navigating Collections (overview page) Adapt current overview page - remove pre-cursor queston
• [x] Live Collections
• [x] Claytons Collections

Largely just move and tidy up navigating how-to

Reference

Move the "failed to turn editing on" and the fix common problems section to reference (from how-to)

• Overview (overview page rework intro, add development and "common problems" sections to the tabs
• Life Cycle
• Conceptual model
• Common problems
• Development (add construction emoji)

Community

About