Linked Questions
30 questions linked to/from More hierarchical structure needed for documentation topics
6
votes
0
answers
45
views
How should anything more complex than small libraries be presented in Documentation? [duplicate]
I am a bit baffled by the structure. For instance, say I want to document an entire class as part of a framework. If I choose to create a topic for that class, I am left with a Syntax section that is ...
4
votes
0
answers
42
views
Documentation structure [duplicate]
Most documentation I find the most helpful tends to be organized in some kind of a tree-like structure. While there is obviously the ability to break information up by tags, and then even more by ...
1
vote
0
answers
34
views
Don't you think that a category system would be useful for Documentation? [duplicate]
Let's say you choose a tag, for example css This tag has only categories in the Documentation, but each category has subcategories in css. Each subcategory need syntax and more examples.
What ...
3
votes
0
answers
21
views
Allow nested topics [duplicate]
Some tags are accumulating hundreds of topics, and many topics are accumulating a lot of examples covering various aspects of the topic.
We should be able to create hierarchies of topics so people ...
270
votes
25
answers
14k
views
Tearing Down the Structure of Documentation [closed]
If you have told us (or privately thought) Documentation isn't working: You are correct. It isn't. Yet.
Since early on in the private beta of Documentation, we’ve used a simple, rigid structure:
Tags =...
497
votes
13
answers
14k
views
The dawn of Documentation: a solstice update [closed]
Normally Kevin does these updates, but I wanted to take an opportunity to talk about how Documentation is doing from my perspective as a community manager. For the last 3 years or so, building ...
361
votes
20
answers
16k
views
Warlords of Documentation: Your Quest(ions Answered) [closed]
A couple of weeks ago we came to meta with a proposed expansion of Stack Overflow: Documentation. The response has been very encouraging: 2,400+ upvotes and even more signups for the beta.
You guys ...
266
votes
16
answers
11k
views
Documentation Update, August 4th [closed]
This is the second post in our series of regular (roughly weekly) updates on the Documentation Beta. See also the previous post in the series.
Shipped Changes
Review Rules
We've just enabled an ...
206
votes
11
answers
2k
views
Documentation doesn't look good right now [closed]
I'm familiar with C# / .Net so I naturally tried to see what was available for those tags.
Currently it just looks like a bunch of random topics:
The dashboard doesn't help either.
Then I tried to ...
185
votes
4
answers
13k
views
Documentation: The Update-en-ing [closed]
Six-to-eight weeks Several months ago we proposed an expansion to Stack Overflow: Documentation. People have been asking for an update for a while, and we’re finally ready to give one.
The beta has ...
243
votes
5
answers
2k
views
Rename "Documentation" to "Examples" [closed]
Let's rename Documentation to Examples, as suggested by @Jeff Atwood (one of the founders of Stack Overflow) here and here.
The term "Documentation" is the root cause of many of the evils we ...
74
votes
7
answers
1k
views
Why is Documentation not ordered in any discernible way? [closed]
I was thinking about the order of the documentation page. For example when I open Java Documentation it should show the first topic as Introduction then Hello World Program and so on. Why is it not ...
58
votes
3
answers
2k
views
Users are creating Topics in Docs without any guidance or cautions [closed]
I've been trying to keep the PHP list of Topics clean. A common issue I'm seeing (and removing) are Topics that are just too localized (i.e. tutorials on how to perform some highly specific task), but ...
66
votes
6
answers
2k
views
What if documentation took its content from Stack Overflow Q&A? [closed]
When I need to look up a concept, I don't go to the official documentation or to Stack Overflow Documentation. I go to a Stack Overflow Q&A.
This is a radical change, but I'll toss it out there. ...
87
votes
1
answer
1k
views
Was there a Documentation post-mortem?
In the post on Sunsetting Documentation, it was stated:
We also plan to write a retrospective on the blog and make this a topic of an upcoming Town Hall Chat. I’m planning a few posts for my ...