3 ms·
Color me not surprised at all Besides the obvious reason, not showing up in search results, there is another glaringly obvious one. Well, obvious to anyone exc
by dmitriid 9y ago
Color me not surprised at all
Besides the obvious reason, not showing up in search results, there is another glaringly obvious one. Well, obvious to anyone except Stackoverflow: their documentation site is horrible.
There was no structure to the docs, no way to create structure or promote relevant parts of the documentation.
Let's open Python docs. Right now it looks like this:
- Getting started with Python Language
- Incompatibilities moving from Python 2 to Python 3
- List comprehensions
- List comprehensions
- Common Pitfalls
- Generators
- Classes
- String Formatting
- Functions
...
Yes, there are two `List Comprehensions`. I mean, wat.
As you go into each "Chapter", they all consist of random sections, and the table of contents (called Topic Outline) helpfully hides all links to all sections saying something like "13 more examples" that you have to click to expand.
And the list of problems just goes on and on and on. All of these issues have been raised numerous times and dismissed out of hand by SO developers.
- Ajedi32 9y agoSounds to me like they didn't really dismiss those issues, they just didn't have the resources to fix them. > Unfortunately, we can't afford to work on the problem at the moment. While we have an exceptional team of engineers, there just aren't enough of them to support all the projects Stack Overflow is working on.
- dmitriid 9y agoThat actually did dismiss it quite a few times until the realisation finally dawned on them in May this year[1]. By then it was already too late. I won't be able to find all the discussions that were happening right around the time it left the private alpha/beta. They were quite heated. [1] https://meta.stackoverflow.com/questions/349410/tearing-down-the-structure-of-documentation https://meta.stackoverflow.com/questions/349410/tearing-down...