C.A.M. Gerlach
C.A.M. Gerlach
> I'm not sure if it's worth unifying the two CSVs and/or tables, since that adds an extra dependency and complexity. You could just put them in the same table,...
(Didn't meant to approve, meant to make that a comment sorry)
> I'm also thinking whether it would be useful to have a "Further readings" list at the end of the tutorial that links to some of the howtos, or perhaps...
Sorry for the long delay on this; I got held up with other things and then was ~being lazy~ taking a break for a day. > I pushed a new...
> OTOH, the best way to learn something is to use it. It did not help that I'd read everything on the Diátaxis page up and down multiple times; I...
I might also suggest refining the team description a touch, perhaps along the lines of "Mention [...] for help with the finer points of English technical writing," to avoid sounding...
> Since make linkcheck is somewhat unreliable and can't be required for regular PR FWIW, for [spyder-ide/spyder-docs](https://github.com/spyder-ide/spyder-docs) which is of the same OOM as this repo, we do run it...
Another related item is that of the [Platform experts list](https://devguide.python.org/core-developers/experts/index.html#platforms), which is rather out of date, and partially duplicated by the more current information in [PEP 11](https://peps.python.org/11). Much of the...
That should be fairly straightforward, but the disadvantage is that its not machine-parsable. However, we could always still move the table sources to CSVs in the PEPs repo at any...
Hope you feel better soon @brettcannon ! Best wishes for a speedy recovery.