Results 216 comments of Jean Abou Samra

I did some experiments, and unfortunately, I hit a bug in RTD that's going to complicate our lives here: readthedocs/readthedocs.org#10963. There is some problem that I don't yet fully understand,...

@pradyunsg made a valid point on https://github.com/pypa/packaging.python.org/pull/1345: if we redirect to an external domain, Sphinx's linkcheck will not check the redirect link, at least until https://github.com/documatt/sphinx-reredirects/pull/6 is merged, whereas it...

I've been reading about how HTML (meta refresh) redirects, as made by sphinx-reredirects, affect SEO. Although there is mixed advice in the wild, the overall theme seems to be "it's...

#1434 highlights an aspect of the problem which has not been mentioned so far, namely how our restructurings affect projects linking to us with Intersphinx. Specifically, we can always keep...

I completely agree with @henryiii. @LLyaudet Please refer to the Diataxis documentation process which we use: https://diataxis.fr/tutorials/ Specifically: """ Offer only minimum, necessary, explanation If the learner doesn’t need an...

> I don't know what kind of pedagogy study supports this: > """ > Offer only minimum, necessary, explanation > > If the learner doesn’t need an explanation in order...

I'm sorry but it would simply take me more time than I have to formulate a thoughtful response (esp. given the "doubt about my intent"). I'm going to just let...

Sorry, this got auto-closed because I wrote "Fixes #1424" in #1426 while I meant "Supersedes #1424". Reopening. I do think that the info added in #1426 (now [here](https://packaging.python.org/en/latest/discussions/distribution-package-vs-import-package/#how-do-distribution-package-names-and-import-package-names-compare)) is sufficient,...