Questions tagged [documentation]
Use this tag for questions about the now phased out Stack Overflow Documentation feature. For posts relating to help pages (documentation for the site itself), use [help-center] instead.
1,375
questions
2918
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 ...
1285
votes
48
answers
159k
views
Sunsetting Documentation
We will stop accepting contributions to Documentation on August 8 2017
On behalf of everyone who worked on Documentation, I want to thank all 15,451 users who contributed. We particularly want to ...
603
votes
10
answers
26k
views
Stack Overflow - Serving Programmers Even Better [closed]
In 2008, we set out to solve a problem that plagued every programmer in the world: the lack of an information resource that was free, vetted and maintained by programmers, where the best information ...
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 ...
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 ...
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 ...
327
votes
9
answers
15k
views
Documentation Reputation Update Is Live [closed]
TL;DR
Noticed your rep change? It’s because we’re deploying an update to the rep in the Documentation Beta as was announced a couple weeks ago. The biggest change: there is now a “minor” ...
289
votes
3
answers
3k
views
Remove "If Q&A is chocolate, Documentation is peanut butter." in the documentation tour [closed]
I don't see how this analogy helps the user to understand what differentiates the Q&A from the documentation. I don't even get the analogy (maybe a cultural thing).
SO is not a place for this ...
285
votes
9
answers
5k
views
Is Documentation failing? [closed]
Are there any stats for Documentation about the activity in a specific tag? I have observed that a niche tag like MATLAB is pretty much dead (last action on Dec 2nd). I personally lost interest in ...
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 ...
282
votes
0
answers
4k
views
Documentation Update, November 29th [closed]
Well, November 2016 sure was a month that happened.
Now that we're on the other side of the US election and holidays (and the team is back at work) it's time for an update on Stack Overflow ...
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 =...
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 ...
249
votes
3
answers
2k
views
Remove or Overhaul Reputation in Documentation [closed]
I think I can speak for many users to state that the current system of reputation gain from Documentation is implemented such that users can take advantage of it for easy reputation gain. I've seen ...
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 ...
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 ...
230
votes
13
answers
2k
views
Docs is broken: Writing Docs we actually need [closed]
The current system rewards writing documentation that is already covered by the official docs. Meanwhile, popular libraries without good official docs are undercontributed. The system is broken, and ...
206
votes
11
answers
2k
views
Documentation doesn't look good right now [closed]
I'm familiar with C# / .Net so I naturally tried to see what was available for those tags.
Currently it just looks like a bunch of random topics:
The dashboard doesn't help either.
Then I tried to ...
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 ...
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 ...
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 ...
185
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 ...
182
votes
6
answers
2k
views
Documentation should be elitist [closed]
This post was inspired by the "Is Documentation failing?" question, but it's something I've been thinking about for the system.
The fact is: The idea of world-editable, world-moderated content makes ...
182
votes
5
answers
15k
views
Documentation is read-only. What’s next? [closed]
As previously announced, Stack Overflow Documentation is now in read-only mode in preparation for its sunset permanent removal from the site. Before we move on, I want to update you all on some ...
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 ...
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....
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 ...
155
votes
3
answers
2k
views
Documentation shares the work: make the rewards shared, not multiplicative [closed]
I've gotten over 350 rep points* since last week for this here Documentation edit. I think it made the example better; I'm pleased to have been able to contribute.
On the other hand, rewriting a ...
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 ...
129
votes
1
answer
4k
views
Documentation Update, September 12th [closed]
This is the fourth post in our series of regular (roughly weekly) updates on the Documentation Beta. See also the previous post in the series.
Shipped Changes
Proposed Changes Review Queue
It ...
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 ...
125
votes
9
answers
4k
views
Addressing Documentation #RepGateApocalypse [closed]
With Documentation going into public beta earlier today, folks have raised a number of concerns over the reputation thresholds. I'd like to take a moment to address those in one place.
We are ...
122
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 ...
114
votes
4
answers
9k
views
Removing Documentation: Reputation, Archive, and Links [closed]
Update: More details about attribution and the current status of link removal can be found in my answer.
Last time I promised we’d release a JSON archive, preserve reputation earned on Documentation, ...
110
votes
3
answers
1k
views
Documentation: Add a way to reject or roll back an edit with prejudice [closed]
Problem case:
Right now in documentation, it takes one user to approve an edit. This is subject to change, but in general, not many users will be necessary for this.
How the distribution of ...
108
votes
4
answers
1k
views
10 reputation for topic editing is too high [duplicate]
On Q & A Stack Overflow, Suggested Edits are a prime source of rep farming; a simple or trivial edit that requires little knowledge of the question content earns users under 2k reputation two rep ...
108
votes
1
answer
4k
views
I've just lost 1760 reputation points without explanation [closed]
That's 22% of my reputation on SO.
Now you see them.
... and now you don't
If this is some "recalculation", then these one-sided updates without warning or explanation aren't the way to go about ...
107
votes
1
answer
865
views
What is currently being done to keep plagiarists at bay? [closed]
There's multiple reports of users just copy&pasting plagiarized content into Documentation.
Are there moderator tools in place so those users can be banned from editing Documentation after a ...
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 ...
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 ...
102
votes
1
answer
870
views
The things that drive me nuts about documentation [closed]
These are some of the things that make me wince every time I enter the documentation side of the site, that I think a decent number of people would agree with. I'd like to see what people think about ...
100
votes
2
answers
791
views
Allow us to roll back a Documentation example, not just an entire topic [closed]
So today I was fielding a flag about another run of plagiarism on Documentation, and found an edit on an example that was plagiarized from a Programmers answer. The rest of the example was original, ...
100
votes
0
answers
870
views
Why am I earning documentation privileges? [closed]
In the past day I've earned two privileges for a feature that doesn't exist any more:
Documentation Review:
Documentation Comments:
Both of these link to help documentation which is still active.
...
98
votes
2
answers
1k
views
Copied content should have automatic consequences [closed]
Today I have rejected several elegant, clever, clear, and otherwise high quality contributions to Documentation. It's the type of thing that you see in books and official websites, which is where it ...
96
votes
3
answers
912
views
Should rep gains be turned off for Documentation's seeding period? [closed]
Given worries about inflationary rep gain and about low-quality content being posted, would it not be wise to turn off any rep gain from Documentation activity until things have settled?
This would
...
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 ...
94
votes
3
answers
696
views
Do not allow only one user to approve documentation edits that have already been rejected by another reviewer [closed]
The other day, I rejected a revision request that contained false information; only to see the same revision approved by another user and incorporated into the docs a day later. When one user has ...
94
votes
2
answers
667
views
Incorrect information in Documentation: The Solution [closed]
Note: This is a feature request from this answer, slightly modified from this comment.
The Problem
There is an issue right now with incorrect information being added to documentation.
Why?
1 rep ...
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 ...
91
votes
3
answers
2k
views
Why is documentation reputation counted as the main reputation? [closed]
TL;DR
or remove the rep gain.. Let documentation be written by people who
are genuinely interesting in creating good documentation. Not by
people who want to earn rep – Tim Castelijns
I would love ...