Migrate documentation

[grst]

Migrate internal documentation to Sphinx.

Envisaged structure of the docs

README

• summary of the features
• links to relevant sections of the documentation

User Guide

• Get started: A step-by-step introduction to basic DSO features
  • @grst: review
• User guide: Details about principles, features and mechanisms of DSO
  • Template engine: mention plan for custom template libraries
  • Config files
  • get-config
  • integration with pre-commit
  • linting
  • integration with uv
  • Integration with DVC (link to relevant DVC docs); e.g. how to reference variables from params.yaml.
  • Quarto integration
    • watermarking
    • configuration in params.in.yaml
  • Syncing DVC changes (mention pre-commit integration)
• Tutorials
  • Converting an existing project into a dso project
  • How to work on an existing dso project
  • <need to figure out if there's anything in addition to "get started" and "user guide" to cover here - more "tutorial" style thant "documentation style">
• FAQ
• Glossary

DSO CLI

• installation: with and without dso-mgr
• command reference
• dso configuration: places to configure dso: pyproject.toml, ENV VARS, .dso.json,

DSO Python API

• Installation -> refer to DSO CLI and mention UV and pyproject.toml.
• typical usage
• Python API reference

DSO R API

Link to pkgdown website (Boehringer-Ingelheim/dso-r#28).

• installation
• typical usage
• R API reference
• Changelog (link)