As of May 31, 2023, we have updated our Code of Conduct.

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.

Filter by
Sorted by
Tagged with
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 ...
Kevin Montrose's user avatar
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 ...
Jon Ericson's user avatar
  • 20.8k
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 ...
Tim Post's user avatar
  • 33.2k
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 ...
Jon Ericson's user avatar
  • 20.8k
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
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 ...
TecBrat's user avatar
  • 3,643
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” ...
Kevin Montrose's user avatar
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 ...
Jorge Leitao's user avatar
  • 18.8k
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 ...
Oleg's user avatar
  • 10.4k
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 ...
Toby Allen's user avatar
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 ...
Kevin Montrose's user avatar
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 =...
Jon Ericson's user avatar
  • 20.8k
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 ...
Kevin Montrose's user avatar
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 ...
Spencer Wieczorek's user avatar
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 ...
Pekka's user avatar
  • 440k
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 ...
Kevin Montrose's user avatar
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 ...
noɥʇʎԀʎzɐɹƆ's user avatar
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 ...
ken2k's user avatar
  • 48k
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 ...
MuertoExcobito's user avatar
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 ...
Jason Sturges'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
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 ...
Kevin Montrose's user avatar
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 ...
Gabe Sechan's user avatar
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 ...
Jon Ericson's user avatar
  • 20.8k
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 ...
Kevin Montrose's user avatar
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....
user avatar
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 ...
Marco Scabbiolo's user avatar
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 ...
jscs's user avatar
  • 63.6k
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 ...
Mark Amery's user avatar
  • 141k
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 ...
Kevin Montrose's user avatar
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 ...
Kevin Montrose's user avatar
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 ...
Adam Lear's user avatar
  • 37.8k
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 ...
John's user avatar
  • 1,806
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, ...
Jon Ericson's user avatar
  • 20.8k
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 ...
Magisch's user avatar
  • 7,312
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 ...
Quill's user avatar
  • 2,719
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 ...
Malt's user avatar
  • 28.7k
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 ...
Pekka's user avatar
  • 440k
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
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 ...
Luis Mendo's user avatar
  • 110k
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 ...
Auden Young's user avatar
  • 1,137
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, ...
Brad Larson's user avatar
  • 170k
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. ...
Serverless chap's user avatar
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 ...
Laurel's user avatar
  • 5,934
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 ...
Pekka's user avatar
  • 440k
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
  • 476k
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 ...
Everyone_Else's user avatar
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 ...
tktsubota's user avatar
  • 9,351
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
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 ...
Mr. Alien's user avatar
  • 153k

1
2 3 4 5
28