Adding mkdocs into guides and cookiecutter template

cookiecutter.json

@@ -18,6 +18,7 @@
     "mesonpy",
     "maturin"
   ],
+  "docs": ["sphinx", "mkdocs"],
   "vcs": true,
   "__year": "{% now 'utc', '%Y' %}",
   "__project_slug": "{{ cookiecutter.project_name | lower | replace('-', '_') | replace('.', '_') }}",
@@ -45,6 +46,11 @@
       "mesonpy": "Meson-python                   - Compiled C++ (also good)",
       "maturin": "Maturin                       - Compiled Rust (recommended)"
     },
+    "docs": {
+      "__prompt__": "Chose your documentation tool",
+      "sphinx": "Sphinx",
+      "mkdocs": "MkDocs"
+    },
     "vcs": "Use version control for versioning"
   }
 }

copier.yml

@@ -82,6 +82,14 @@ backend:
     "Maturin                        - Compiled Rust (recommended)": maturin
   # [[[end]]]
 
+# [[[cog print(cc.docs.yaml()) ]]]
+docs:
+  help: Choose your documentation tool
+  choices:
+    "Sphinx": sphinx
+    "MkDocs": mkdocs
+  # [[[end]]]
+
 # [[[cog print(cc.vcs.yaml()) ]]]
 vcs:
   type: bool

docs/README.md

@@ -11,7 +11,7 @@ scientists and research software engineers. The repository contains:
 ## Contributing to the documentation
 
 To build locally, install rbenv (remember to run `rbenv init` after installing,
-and `rbenv install 3.1.2`). Then:
+and `rbenv install 3.4.1`). Then:
 
 ```bash
 bundle install