Linked Questions

2914 votes
94 answers
105k views

Warlords of Documentation: A Proposed Expansion of Stack Overflow

It’s been 7 years and 10,000,000+ Questions since Stack Overflow was launched. The amount of good that has been done for the field - all the developers helped, all the person-hours saved, all the ...
Kevin Montrose's user avatar
360 votes
20 answers
16k views

Warlords of Documentation: Your Quest(ions Answered) [closed]

A couple of weeks ago we came to meta with a proposed expansion of Stack Overflow: Documentation. The response has been very encouraging: 2,400+ upvotes and even more signups for the beta. You guys ...
Kevin Montrose's user avatar
186 votes
9 answers
3k views

Can we please introduce more reputation limits for examples on Documentation? [closed]

Documentation. Also known as a gold mine for people who love to get easy reputation points. Right now it's being (ab)used by many users, some of whom are using it to exponentially increase their ...
angussidney's 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
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 ...
Suragch's user avatar
  • 499k
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 ...
user avatar
65 votes
6 answers
1k views

Why fade out meta answers that have high down-vote count?

This tag is for questions specific to down-votes, the community's way of telling peers that their content can be improved. Down-votes on meta site have different meanings. https://meta....
Mulan's user avatar
  • 132k
56 votes
25 answers
3k views

Naming the Documentation Feature [closed]

In "Warlords of Documentation: Your Quest(ions Answered)", Kevin Montrose mentioned: Is Documentation the right name? This is a tricky one, as there seems to be a fair amount of variance in ...
zzzzBov's user avatar
  • 177k
52 votes
1 answer
462 views

Make Examples look more like questions in Q&A [closed]

When I discovered Stack Overflow, I remember that the interface was immediately intuitive to me. Title goes here, question goes there, add tags, done. Add a comment, cool. Share the link, easy. Vote ...
Pekka's user avatar
  • 446k
41 votes
2 answers
754 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? ...
Willl's user avatar
  • 223
38 votes
12 answers
3k views

The Foundations of Collectives and its Future

Since the announcement of Collectives™ on Stack Overflow, we’ve seen a number of potential narratives emerge for how and why Collectives exist. So in the spirit of continued transparency, I thought I’...
Teresa Dietrich'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
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
10 votes
0 answers
206 views

Review Audit - Questionable "Bad" Answer

I failed the following audit, but want to ensure that I truly understand why this answer deserved to be marked as a "bad" answer. The answer in question I understand that it's not a stellar ...
Tyler's user avatar
  • 750
2 votes
1 answer
74 views

Are users with low reputation supposed to be able to see a completed close vote review?

As I understand it, at 250 reputation you can view close votes on your own questions, not other people's questions. Naturally, I found it interesting when I saw that I could view this link given on ...
iRove's user avatar
  • 562
2 votes
0 answers
258 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. ...
Philip C's user avatar
  • 1,827
-3 votes
1 answer
92 views

Examples are less important to understanding something - move them last [closed]

There is too much stress on examples via documentation. Examples are put at the top as the first section when you click on a topic. To me when I ask someone to read documentation, I am asking them ...
JonH's user avatar
  • 32.9k