Linked Questions
13 questions linked to/from Can Documentation go back to private beta?
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 ...
1041
votes
6
answers
55k
views
Why is there no dark theme on SO? [duplicate]
I think SO should implement dark theme. All major interfaces have a dark theme because it's better for the eyes.
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 ...
93
votes
2
answers
2k
views
What, exactly, is Documentation? [closed]
I read the tour page on Documentation and it looks to me like it is meant to document errors and such things. That seems broad to me. Could anyone explain exactly what it is and how it's going to be ...
31
votes
3
answers
771
views
A better Documentation model: Task, not Topic [closed]
The current documentation model is focused on a set of arbitrarily defined topics, within which are examples.
I believe that this model has led to widespread confusion about what Docs.SO is for, and ...
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 ...
80
votes
2
answers
551
views
Why are there no comment features for examples? [closed]
So I see something I feel strongly about in a Documentation example - a bad practice.
My first instinct would be to add a comment to discuss this with the author.
But that's not possible.
No, I don'...
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 ...
42
votes
1
answer
471
views
What is the purpose of voting on Documentation? [closed]
On the Q&A site, voting lets me distinguish between good and bad answers (also, questions).
What purpose does voting have on the Documentation site?
It's probably not the same purpose - the ...
21
votes
1
answer
252
views
Should we prevent too granular documentation that already exists elsewhere? [closed]
I've noticed this happening mostly in the CSS tag. While programming languages documentation seems to be focused on problems (e.g. "Array sorting"), CSS has a lot of topics about basic language syntax....
32
votes
1
answer
389
views
Documentation: Support for lack of 1:1 correspondence of SO tags to Docs.SO tags [closed]
Many times, we create tags in SO for different versions of a language/library/etc. This is fine for SO, since we use tags for categorization and finding the right audience for a question.
But in Docs....
-8
votes
1
answer
290
views
Get rid of Documentation [closed]
Personally I think it should be scrapped and started again, assuming there is a good reason to start again that is.
It's pretty basic in functionality so it's not hard to replicate the extent of its ...
2
votes
0
answers
257
views
An alternative direction for Stack Overflow Documentation: as a Code Repository [closed]
I was reading yet another "Has Documentation Failed?" question, and came across this:
... most examples on Docs.SO are not "real-world code". They're artificial, used to explain a specific point.
...