Linked Questions

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 Ericson's user avatar
  • 21.2k
169 votes
26 answers
6k views

Documentation Has Entered Public Beta [closed]

The big expansion we started on so many months ago, Documentation, is finally out of private beta! Take a moment and read the blog announcement Also go and play with Documentation for a bit, read ...
Kevin Montrose's user avatar
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
239 votes
13 answers
9k views

Documentation Update, July 25th [closed]

As part of the Documentation Beta, we’re going to be doing a series of meta posts (and blog posts in all likelihood) with what we’ve learned, and what we’re planning to change accordingly. See the ...
Kevin Montrose's user avatar
284 votes
13 answers
4k views

Don't give me reputation points for making an edit to a Documentation topic [closed]

My reputation score is still low enough that I get excited when I see I have jumped +40 points in one day. Oddly today this happened, and I found it was because people had upvoted a topic that I had ...
Toby Allen's user avatar
  • 11.1k
202 votes
10 answers
2k views

Minimum tag score for adding documentation [closed]

Since the documentation has launched, I have noticed that there are many entries are being written by users with low or no tag score. For example, the C++ preprocessor section, some of the posts were ...
MuertoExcobito's user avatar
164 votes
5 answers
3k views

Can Documentation go back to private beta? [closed]

There are still a lot of bugs in Documentation, many people saying how bad it is (because it actually is), edit wars on every example that gets more than 20 votes up, many people trying to get their ...
Marco Scabbiolo's user avatar
194 votes
4 answers
3k views

How much reputation is given per documentation post per day - convert to community wiki [closed]

Has anyone looked into specific numbers of how much reputation is being given out on documentation? It's like a hyperinflation, crashing any meaning to reputation as a measure of trust. If you take ...
Jason Sturges'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
  • 446k
169 votes
4 answers
3k views

Documentation is on its way to becoming the next W3Schools [closed]

Motivation: I only posted this because I have seen complaints from others about the exact same type of behavior in multiple tags. I was able to participate in the non-public documentation period....
user avatar
103 votes
5 answers
1k views

How does Stack Overflow Documentation differ from official documentation? [closed]

I have gone through some posts about Stack Overflow Documentation (1, 2, 3), and I haven't found a clear, simple answer to the question: do we really need it? As I see it, there are currently (at ...
Luis Mendo's user avatar
  • 112k
84 votes
4 answers
3k views

Who is the target audience for documentation? [closed]

I am a semi-frequent contributor to the C++ Language documentation section. I am currently dissatisfied with the "Hello World" example. As of the time of writing, it is over 600 words and contains ...
CinchBlue's user avatar
  • 6,104
16 votes
2 answers
247 views

What's the focus of Documentation? [closed]

I was under the impression that Documentation was geared towards self-contained, short and pragmatic examples, since often we learn something by first trying it. However, prose seems to prevail and ...
Oleg's user avatar
  • 10.5k
47 votes
2 answers
824 views

Documentation by example: Example of good documentation [closed]

The apparent foundation of Docs.SO is the belief that examples are more important than text. That seeing an example communicates better than words. There appears to be a general misunderstanding ...
Nicol Bolas's user avatar
32 votes
2 answers
647 views

Reduce importance of examples in Documentation [closed]

From what I understood from the numerous discussions about Documentation and from the tour, Documentation is based on the following hypothesis: documentation based on examples is more useful than a ...
Jorge Leitao's user avatar
  • 19.6k
56 votes
1 answer
834 views

Why was my Topic+Examples deleted without explanation? [closed]

Yesterday I spent several hours creating a Topic with 6 Examples showing how to drag shapes on html5 canvas. Today my Topic was deleted without explanation by moderator animuson. The now deleted ...
markE's user avatar
  • 104k
5 votes
2 answers
269 views

Will Documentation duplicate effort and waste resources? [closed]

Disclaimer: I do not speak for any projects. I have helped with the documentation of these two projects, that's all. PHP has really good documentation, with lots of examples. Maybe some curation ...
chx's user avatar
  • 11.5k
33 votes
1 answer
870 views

Linking to Documentation gives you +5 reputation [closed]

I answered a question here and referred to one article I contributed to documentation in the initial days. I got 5 rep as you can see from below screenshots: Why do we need to get rep for ...
TheGameiswar's user avatar
  • 28.4k
34 votes
1 answer
331 views

Chaos building in SQL-section of documentation [duplicate]

There is chaos building in the SQL-section of the documentation. People are adding samples from various (incompatible) SQL-dialects, and there is no mentioning which SQL-dialect it is. For example:...
Stefan Steiger's user avatar
27 votes
0 answers
260 views

Trying to understand Stack Overflow Documentation [closed]

Someone will probably point me to a readme/blogpost, but I don't really understand Stack Overflow documentation. Maybe it should be renamed Stack Overflow Examples? Documentation usually ...
gman's user avatar
  • 104k
-8 votes
1 answer
313 views

How do we write good questions and answers? [closed]

Yes I am revisiting this, but please remember that I'm also asking about answers, not just questions. There are a lot of frustrated users, including me, who want to write good questions, but just can'...
user avatar