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
334 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 ...
TecBrat's user avatar
  • 3,719
193 votes
16 answers
4k views

Off topic questions have to be cleared out of the way, but NOT via closure

Recently I ran across a particular question on Stack Overflow. Despite its being quite easy to answer, it has got no answer yet (and most likely won't, as questions older than a hour hardly receive ...
Your Common Sense's user avatar
183 votes
4 answers
13k views

Documentation: The Update-en-ing [closed]

Six-to-eight weeks Several months ago we proposed an expansion to Stack Overflow: Documentation. People have been asking for an update for a while, and we’re finally ready to give one. The beta has ...
Kevin Montrose's user avatar
129 votes
6 answers
3k views

Is Stack Overflow becoming an error-detection site?

Recently I have noticed that more and more questions that really are syntax mistakes, and really small mistakes that could easily be fixed. Why is this bad? If you see many older posts prior to ~...
user avatar
106 votes
5 answers
5k views

Documentation Update, February 6th [closed]

It is time for 2017's first major upgrade to Stack Overflow Documentation — a new Discussion feature plus some other improvements to menus, spam-prevention, review audits and the ever-popular ...
Kevin Montrose's user avatar
81 votes
2 answers
815 views

Will there be a close reason for "Covered in Docs"? [closed]

Since we started building a ton of examples in Documentation, will there be a close reason in the future when the question is clearly covered in one of the doc examples?
juergen d's user avatar
  • 204k
22 votes
3 answers
435 views

Does Documentation deprecate canonical dupe target lists? [closed]

There are various old "What does this symbol mean" lists of community wiki canonical dupe targets which seem to have a great acceptance by the community, like Reference - What does this symbol mean ...
Oriol's user avatar
  • 287k
56 votes
3 answers
710 views

The forms and quality of Documentation Topics [closed]

Much has been said about what "topic" means on Docs.SO. The Powers That Be seem to feel that it is best for users to decide what "topic" means. Now that we're 3 weeks in, I thought it would be good to ...
Nicol Bolas's user avatar
31 votes
3 answers
777 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 ...
Nicol Bolas's user avatar
121 votes
2 answers
3k views

Why did Stack Overflow docs choose such a simple structure of organizing documentation? [closed]

I'm not sure about the motivation behind creating the SODocs project. But I'm personally very disappointed by it. If you are looking for the solution to a very specific problem, Stack Overflow is ...
John's user avatar
  • 2,008
47 votes
2 answers
873 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 ...
Nicol Bolas's user avatar
21 votes
1 answer
2k views

Do we really need documentation for [youtube-api]? [closed]

The Stack Overflow Documentation of [youtube-api] is, at this point, not very advanced, to say the least. Obviously I can't speak for you, but I personally always try to consult the official ...
paolo's user avatar
  • 2,538
69 votes
0 answers
571 views

Docs rep should promote good edits, not word+code dumps [closed]

Looking at this edit, I see a truly useless Example getting whipped into shape. Surely, its author is a "major contributor"? No; instead we have the OP (whose post was good) along with the person ...
Frank's user avatar
  • 66.8k
56 votes
0 answers
525 views

Make documentation more searchable [closed]

I would like to propose some better ways to search documentation. Right now if I want to find something in the documentation it's terribly difficult. It's good to make people write good documentation ...
Cimbali's user avatar
  • 11.4k
2 votes
0 answers
42 views

How are readers linked to an Example supposed to navigate to the Remarks? [closed]

In What's Documentation for? the OP noted that the Example [in Topic "Asyncio Module"] uses concepts like "asyncio" and "executors" without explanation even though this is my first time ...
Frank's user avatar
  • 66.8k