C.A.M. Gerlach

Results 454 comments of C.A.M. Gerlach

Thanks! > Perhaps link to Sphinx's copy instead? https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html We definitely want to do this if and when PEP 676 is implemented, since its a lot friendlier and better organized,...

It could either be hacked around with JS and applying a custom directive or adding the class to some specific body element, or something could be done at build time...

This was discussed at the December Python Docs Community meeting, and it was generally agreed that moving ahead with this would be a good first step, alongside the equivalent python/devguide#1000...

Oh nice, I didn't expect it to be _that_ simple, since I've had to deal with some fairly complex sticky top bars, but then again it's probably because I'm not...

> It might need to be a render-blocking JS (for anchor links to have the offset on first render -- I don't know when the browser does the actual scroll...

As far as I can tell, the original two points @vstinner listed above are as of now at least mentioned in the PEP, as sub-bullets under the final list item,...

Thanks @encukou ! I've updated the list above to reflect both.

> Cam points out we require Python 3.9 as a minimum, which might also allow for slightly cleaner code when it comes to it. Yeah, there is a lot of...

> Personally I'd hold off on updating it -- it requires at least testing to ensure everything works, and (contingent on 676 being accepted) the file will just be deleted....