Linked Questions

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 ...
Nicol Bolas's user avatar
269 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 =...
Jon 'links in bio' Ericson's user avatar
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. ...
Goose's user avatar
  • 4,764
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 ...
Machavity's user avatar
  • 30.9k
122 votes
2 answers
3k views

Why did Stack Overflow docs choose such a simple structure of organizing documentation? [closed]

I'm not sure about the motivation behind creating the SODocs project. But I'm personally very disappointed by it. If you are looking for the solution to a very specific problem, Stack Overflow is ...
John's user avatar
  • 1,866
496 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 ...
Jon 'links in bio' Ericson's user avatar
20 votes
1 answer
199 views

Increase the character limit for Documentation introductions [closed]

As per the documentation update of november 29th, a "Introduction" section was added for documentation topics. Since I "abused" a pinned example to serve as an introduction, on a topic I wrote, I ...
Cerbrus's user avatar
  • 70.9k
4 votes
0 answers
64 views

Documentation: Has there been any discussion around related/linked documentation topics? [closed]

Has there been any discussion of how to re-use or group together documentation that is relevant to multiple technologies? Linux seems like a big problem in general. Ubuntu, Mandrake, Puppy, Red Hat, ...
BenPen's user avatar
  • 383
7 votes
0 answers
265 views

'popular' in documentation

In documentation when 'popular' tab is selected, the tags are ordered based on the number of topics each tag has got (screenshot below). In the main page of each tag, it looks 'popular' tab orders ...
start2learn's user avatar
57 votes
3 answers
710 views

The forms and quality of Documentation Topics [closed]

Much has been said about what "topic" means on Docs.SO. The Powers That Be seem to feel that it is best for users to decide what "topic" means. Now that we're 3 weeks in, I thought it would be good to ...
Nicol Bolas's user avatar
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 ...
Pekka's user avatar
  • 442k
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 ...
Guybrush Threepwood's user avatar
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 ...
PSN's user avatar
  • 2,346
267 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 ...
Kevin Montrose's user avatar
3 votes
0 answers
43 views

Add stackoverflow-style tags to topics [duplicate]

There's been a post requesting a hierarcheral to documentation, but I think it's not very user friendly. Instead, I propose Stack Overflow tags. They take longer to access and are more complex Take a ...
noɥʇʎԀʎzɐɹƆ's user avatar

15 30 50 per page