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
  • 20.8k
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
  • 5,218
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
32 votes
2 answers
646 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
  • 18.8k
-8 votes
1 answer
307 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
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
  • 440k
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 ...
Kevin Montrose's user avatar
32 votes
1 answer
863 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
  • 27.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
  • 102k
102 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
  • 110k
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
  • 99k
34 votes
1 answer
330 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
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
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
163 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

15 30 50 per page