Zach Mitchell

@roberth assigned to you for feedback

So I misread what this Sphinx module does, it tracks which _files_ have redirect to one another, but not which _URLs_ redirect to one another. These are the Sphinx-specific redirect...

Me, @yukiisbored, and @henrik-ch worked on this together and we have automatic redirects working with a couple of caveats: - [x] We need this repo converted to use `nixpkgs` instead...

Under `python310Packages` we have: - [x] livereload - [x] myst-parser - [x] sphinx - [x] sphinx-book-theme - [x] sphinx-copybutton - [x] sphinx-design - [x] black I haven't checked that these...

If we're getting rid of `poetry` would we just have a single `mkDerivation` that's essentially what `nix-dev-html` does?

I've removed all of the `poetry` stuff but I've hit this error: ``` error: Package ‘python3.10-sphinx-book-theme-0.3.3’ in /nix/store/0acd255ca1v8m4xcg5wjhi9pgmx7q2s5-source/pkgs/development/python-modules/sphinx-book-theme/default.nix:35 is marked as broken, refusing to evaluate. ```

Looks like there's a [compatibility issue](https://github.com/executablebooks/sphinx-book-theme/issues/592) between this theme and `sphinx`. The version of `sphinx` in `python310Packages` is v5.1.1, but v0.3.3 of `sphinx-book-theme` isn't compatible with this version of `sphinx`....

The PR is here: https://github.com/NixOS/nix.dev/pull/515

Related: https://stackoverflow.com/questions/18146107/how-to-add-blog-style-tags-in-restructuredtext-with-sphinx

Discussed in documentation team meeting Order of priority: - Link to source document - Either author by-line or CODEOWNERS link - Git-blame view and other fancier forms of reporting activity