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 responses to your feedback.
I’m enormously encouraged by the thoughtful comments and answers to the announcement. The “We-told-you-so’s” were well earned and the expressions of disappointment were respectful. Writing that announcement was the most challenging thing I’ve done on this job. It’s a mark of this community’s maturity that reading the replies was enjoyable rather than stressful. Thank you all.
Content
Nothing has changed in our plans so far. We still plan to release a JSON archive, but the exact structure and what will be included hasn’t been nailed down. We’ll let you know when we have more details.
Reputation
Nothing has changed about our goals with reputation, but we’ve been working out the implementation details. Our initial thought was that a single Documentation reputation entry would be most efficient. But Nick Craver reminded us that we need to be able to do reputation recalculations from time to time. Doing reputation right means we’ll need to keep Documentation reputation events in an archive table so that we can account for things like people hitting their rep cap for the day.
Badges
Forget our original plan. We’re planning on implementing Panda’s suggestion:
We might tweak the name and description of the final badge, but the idea is to preserve the two existing participation badges and award a third one.
Links
We were overwhelmed with the voting on the generous offer to help clean up the links. I was reluctant to ask this of the community since it violated the fix-what-you-break principle. But it really will be best to treat this like a tag cleanup. Our primary responsibility will be to provide you all with a list of links to posts that need fixing. (More on that soon.) But there’s still one more issue we need to consider first:
Attribution
Nicol Bolas pointed out there’s a potential difficulty using content from Documentation: How can we provide attribution once the content is removed from the site? At a minimum, linking to the data dump when content from Docs is copied into Q&A provides a path to identifying the authors which satisfies the attribution requirements of the license. However, we feel this approach isn’t the best experience and I’m guessing you will agree. Since the earliest days of Stack Overflow, we’ve valued giving credit directly to the individuals who created the work. Ideally, author’s names (and links to their profiles) would be included right next the content. To honor this spirit of attribution, please consider adding links to the primary authors of the content, when possible.
We realize that in the case of Docs, there are quite a few examples that have many authors. The Java Creating and Initializing Arrays example had 80 active contributors and 163 total editors. Listing each name would make a post unwieldy. But then again, that example is probably too large to be part of a good answer. It’s entirely possible we’d just want to remove the link entirely for most examples touched by many contributors.
In summary, here’s what we’d like to suggest when editing Q&A posts with links to Docs:
If an example link doesn’t add much to the post, feel free to just remove the link.
If the author wrote both the Documentation content and the post (especially if you are the author), edit in the relevant parts of the content and mention in the revision history that the additions came from Documentation. Since the author already has their user card under the post, there’s no need for more attribution in this particular case.
If the content has multiple contributors, consider linking to the top few major contributors.
As a ground rule—always link to the Documentation archive so that attribution is traceable if copying content.
We'll publish a link to the data dump and a list of posts that will need attention as soon as we have them ready.