Linked Questions
21 questions linked to/from What, exactly, is Documentation?
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 =...
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 ...
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 ...
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 ...
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 ...
201
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 ...
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 ...
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 ...
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 ...
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....
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 ...
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 ...
16
votes
2
answers
245
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 ...
47
votes
2
answers
767
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 ...
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 ...
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 ...
5
votes
2
answers
268
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 ...
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 ...
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:...
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 ...
-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'...