Docs reorg

[cliffckerr]

Propose the following reorganization of the docs, following https://diataxis.fr.

In brief, the idea is to turn the tutorials into something more like a "quick start guide" ("showing a single path that works"). Some of the tutorial content, and the developer tutorial content, will be moved to a "user guide" ("how-to guide"), that go into much more depth about the explanation and different possible options for that particular feature.

Current

Tutorials

• T1 - Getting started
• T2 - How to build your model
• T3 - Demographics
• T4 - Diseases
• T5 - Transmission
• T6 - Interventions
• T7 - Calibration

Developer tutorials

• Diseases
• Flexible parameters
• Analyzers
• Nonstandard usage

Proposed

Tutorials

• T1 - Getting started
• T2 - Building a model
• T3 - Diseases & transmission
• T4 - Interventions & analyzers
• T5 - Workflows

User guide

Introduction

• What is Starsim?
• Starsim applications

Basics

• Model structure
• The Sim object
• The People object

Modules

• Diseases
• Networks & transmission routes
• Demographics
• Interventions
• Analyzers
• Connectors

Workflows

• Multiple runs
• Calibration
• Samples
• Cloud computing

Advanced topics

• Time
• Indexing
• Parameters
• Distributions
• Random numbers
• Performance and profiling
• Nonstandard usage

Thoughts @JSchripsema-IDM @daniel-klein @robynstuart @RomeshA @pausz @jamiecohen?