Linked Questions
10 questions linked to/from The forms and quality of Documentation Topics
270
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 =...
335
votes
13
answers
12k
views
Is Documentation a failed experiment? [closed]
Early on, I made some small change to some small part of PHP Documentation and occasionally see a single rep point pop up, but I NEVER find myself visiting it for ANY reason now.
Matteo Italia's well ...
126
votes
6
answers
7k
views
Documentation Update, August 29th [closed]
This is the third post in our series of regular (roughly weekly) updates on the Documentation Beta. See also the previous post in the series. Yes, it’s been three weeks since the last update, but at ...
140
votes
5
answers
2k
views
What's Documentation for? [closed]
I've been raising this question occasionally in comments for a while now, but I thought it was worth asking it as a Meta question: just what's the point of Documentation? What niche do the development ...
94
votes
3
answers
1k
views
More hierarchical structure needed for documentation topics [closed]
I originally posted this in the documentation beta, but it got no response and almost no views there. I'm not sure if it's because few people are monitoring the documentation beta or because the topic ...
21
votes
4
answers
836
views
Are examples allowed to be too large? [closed]
There is some debate on what the size of an example should be. Some of the discourse has been focused on the balance between prose and code, and some between snippet or tutorial.
However, I would ...
23
votes
3
answers
515
views
Examples limit on documentation causes examples to be smushed together [closed]
This post is 4 examples in one - and they seem unrelated. It all comes under the topic banner, but there is no good reason for them to be together.
So I edit 3 out, and go to add a new example but ...
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 ...
41
votes
2
answers
752
views
What level of experience should we assume for readers of SO Documentation? [closed]
I was making a couple of updates to the HTML documentation and realised that I wasn't clear on exactly who the audience is meant to be. If it's introductory material how introductory should it be? ...
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 ...