🎨 Update docs theme and add tutorial (#1184)

- Update the theme to furo and style colors to match new branding
  - branding coloring loosely based on https://mintlify.com/docs/quickstart 
- Restructure toc-trees, to make the documentation easier to navigate
- Improve landing page
   - Improve top "hero" section
   - Add feature section
   - move examples to tutorial
- Add tutorial page, with worked example covering most directives
  - took some things from https://sphinx-needs-demo.readthedocs.io

Author: chrisjsewell

.gitignore

@@ -23,9 +23,6 @@ coverage.xml
 .doctrees
 docs/github_images/
 .eggs/
-docs/_images/need_pie_*.*
-
-docs/_images/need_bar_*.*
 
 
 .devcontainer/
@@ -36,8 +33,6 @@ docs/_images/need_bar_*.*
 tests/cypress/
 cypress/
 
-need_bar_*.png
-need_pie_*.png
 output.json
 mem_out.*
 

.readthedocs.yml

@@ -11,7 +11,7 @@ python:
       path: .
       extra_requirements:
         - docs
-        - theme-im
+        - theme-furo
 
 build:
   os: ubuntu-22.04
@@ -27,4 +27,4 @@ build:
     pre_build:
       # ideally we would just set the DOCS_THEME environment variable
       # but I couldn't see an easy way to do that for the build job
-      - 'echo "sphinx_immaterial" > docs/DOCS_THEME'
+      - 'echo "furo" > docs/DOCS_THEME'

docker/Dockerfile

@@ -2,7 +2,7 @@
 # syntax = docker/dockerfile:1.2
 ARG BASE_IMAGE=sphinxdoc/sphinx:latest
 FROM $BASE_IMAGE
-LABEL maintainer="Useblocks <https://useblocks.com/>"
+LABEL maintainer="useblocks <https://useblocks.com/>"
 
 ARG DOCKER_USERNAME=dockeruser
 ARG DOCKER_USER_ID=1000