-
-
Notifications
You must be signed in to change notification settings - Fork 31.9k
faq/library: remove outdated sections #105996
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
faq/library: remove outdated sections #105996
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for helping keep things tidy! I agree that it's valuable to ensure that FAQs are at least somewhat frequently asked.
That said, for pyserial, I'd err on the side of Chesterton's fence and leave it in. pyserial is in the 674th most downloaded PyPI package in the last thirty days, so many people are getting value out of it.
I accept your reasoning in the condition that the other 673 packages more popular than pyserial also get their own entry in the FAQ ;) |
That's amusing :-) From my perspective, I don't find this FAQ well correlated with the questions I personally would ask frequently. So to your point, yes, I am using a criterion of "could a reasonable number of people find this existing question useful" and the pyserial mention passes this test. If I instead used the criterion of "what questions would I frequently ask", I'd end up deleting most of the existing FAQ. This might well worth be doing (at the very least, would benefit future me's), but is a different scope and would require soliciting input from other core devs. |
This reverts commit 82d64dd.
Thank you for improving this! |
Thank you for considering my work 🙏 |
I broke it into 3 commits so we can revert some deletion if we wish:
In a general matter, I think we should remove links preserved through archive.org. That the page went down and that nobody bothered to generate a reliable copy is a clear marker that the page is no longer relevant in today's world.
A good example of this is Joel's The Absolute Minimum Every Software Developer Absolutely, Positively Must Know About Unicode and Character Sets (No Excuses!). It will be 20 years in few weeks. It has been non-stop alive since then because it has always been relevant, until today, 20 years later.
📚 Documentation preview 📚: https://cpython-previews--105996.org.readthedocs.build/