Switch from using rubric in release notes

[ivirshup]

Just something that always bothered me. Plus if we want to put release notes on github it'd be nice to have less that needs reformatting.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 84.44%. Comparing base (c0b4e8f) to head (72b60ff).
Report is 73 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1346   +/-   ##
=======================================
  Coverage   84.44%   84.44%           
=======================================
  Files          36       36           
  Lines        5747     5747           
=======================================
  Hits         4853     4853           
  Misses        894      894           

[flying-sheep]

Good call! We should also make sure that people can link to patch versions.

For some reason, anchors like #version-0-10 exist, while 0.10.5 currently has the (unstable) anchor #id5

[ivirshup]

For some reason, anchors like #version-0-10 exist, while 0.10.5 currently has the (unstable) anchor #id5

I have a local commit for this

The problem is that sphinx can't do ids that start with numbers, so I added "Version". I would also like to keep the date out of it so it just looks like

https://anndata.readthedocs.io/en/latest/release-notes/index.html#version-0-10-5

But that might require putting the date on a separate line, which I'd rather not do.

[flying-sheep]

Yeah, that would be great! Mabye we can define the smaller role in a way that hides it from Sphinx’ slug generation mechanism. Now that we use scanpydoc again, centralizing that is easy.

[flying-sheep]

By now, this is enforced in .readthedocs.yml

Having it twice helped against the most egregious offenders, but by now I’m in a more active role and can prevent the other instance from being removed.

[flying-sheep]

the v is load-bearing, without it the generated HTML anchors are generic id40 ones as mentioned above.

We could also use myst_heading_slug_func

[flying-sheep]

this release doesn’t actually exist