Updating mkdocs

Author: Samreay

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

docs/pages/guides/docs.md

@@ -24,19 +24,21 @@ and uses the modern MyST plugin to get Markdown support.
 >
 > - [Sphinx](https://www.sphinx-doc.org/en/master/): A popular documentation
 >   framework for scientific libraries with a history of close usage with scientific
->   tools like LaTeX.
-> - [JupyterBook](https://jupyterbook.org): A powerful system for rendering a
->   collection of notebooks using Sphinx internally. Can also be used for docs,
->   though, see [echopype](https://echopype.readthedocs.io).
+>   tools like LaTeX. Examples include [astropy](https://docs.astropy.org/en/stable/index_user_docs.html)
+>   and [corner](https://docs.astropy.org/en/stable/index_user_docs.html).
 > - [MkDocs](https://www.mkdocs.org): A from-scratch new documentation system
 >   based on markdown and HTML. Less support for man pages & PDFs than Sphinx,
 >   since it doesn't use docutils. Has over
 >   [200 plugins](https://github.com/mkdocs/catalog) - they are much easier to
 >   write than Sphinx. Example sites include [hatch](https://hatch.pypa.io),
 >   [PDM](https://pdm.fming.dev),
 >   [cibuildwheel](https://cibuildwheel.readthedocs.io),
->   [Textual](https://textual.textualize.io), and
->   [pipx](https://pypa.github.io/pipx/).
+>   [Textual](https://textual.textualize.io), 
+>   [pipx](https://pypa.github.io/pipx/), [Pydantic](https://docs.pydantic.dev/latest/), 
+>   [Polars](https://docs.pola.rs/), and [FastAPI](https://fastapi.tiangolo.com/)
+> - [JupyterBook](https://jupyterbook.org): A powerful system for rendering a
+>   collection of notebooks using Sphinx internally. Can also be used for docs,
+>   though, see [echopype](https://echopype.readthedocs.io).
 
 ## What to include
 
@@ -69,16 +71,16 @@ with render_cookie() as package:
 
 ## Hand-written docs
 
-Create `docs/` directory within your project (i.e. next to `src/`). From here, 
+Create `docs/` directory within your project (next to `src/`). From here, 
 Sphinx and MkDocs diverge.
 
-{% tabs %} {% tab sphinx Sphinx %}
-
+{% tabs %}{% tab sphinx Sphinx %}
 
 There is a sphinx-quickstart tool, but it creates unnecessary files (make/bat, we recommend
 a cross-platform noxfile instead), and uses rST instead of Markdown. Instead,
 this is our recommended starting point for `conf.py`:
 
+
 ### conf.py
 
 <!-- [[[cog
@@ -265,7 +267,7 @@ If you selected the `mkdocs` option when using the template cookie-cutter reposi
 
 ```toml
 [dependency-groups]
-docs = docs = [
+docs = [
     "Markdown>=3.9",
     "mkdocs>=1.1.2,<2",
     "mkdocs-material>=9.1.19,<10",