-12

Backstory

I've saved some Stack Overflow Documentation links as reference for a CSS training that I have, and, knowing that those links would be broken in near future (and, having that it's just simple markup), I've taken a copy of the markup content of those links to my GitHub repository, including the recommended attributions.

Suggestion

I think it would be nice if we could keep Documentation as a whole in GitHub, instead of just letting it go to archive.

What do you think? Any comment or idea? Maybe create an archive parser? Maybe Stack Overflow itself have an easier way to do that?

We could possibly continue contributing to Documentation there.

Or, just archive it there.

Related links

1
  • 3
    The Docs project failed because it generated a lot of bad documentation. You'll have a hard time convincing anybody that replicating bad docs is a good idea. And be careful, using a link in a post to your repository is okay, but the post still needs to be informative enough without that link. Dec 5, 2017 at 17:36

2 Answers 2

11

One of the big reasons that Documentation wasn't a huge success was the barrier to entry, as well as what qualified as "good" documentation. By opening it up to anyone that wants to submit a PR, you run into two nightmares:

  • Everyone will submit that damn Java arrays documentation again. No one will actually write meaningful documentation when they can rattle off something from a book or website.
  • Being able to filter out the noise from the signal becomes exponentially harder, given that there are more people out there that know the basics and are more than willing to share them, as opposed to the people that know the harder stuff.
6
  • What barrier to entry? 🙄
    – BoltClock
    Dec 5, 2017 at 16:54
  • "How do I write good documentation?" "What qualifies as good documentation?" There are other points besides those enumerated in the discussion leading up to its sunsetting as well.
    – Makoto
    Dec 5, 2017 at 16:56
  • Oh that. I thought you were referring to some sort of site privilege.
    – BoltClock
    Dec 5, 2017 at 16:57
  • 1
    I recall there being some miniscule amount of gating - that is, there likely was a minimum reputation involved - but those aren't significant barriers in the face of not knowing how to actually author good docs.
    – Makoto
    Dec 5, 2017 at 16:59
  • 2
    ugh... java arrays... Dec 5, 2017 at 17:04
  • 5
    @FélixGagnon-Grenier: Yes. It has left an indelible mark on us all in some way. Let us record it in every history book available so that we will make that mistake Never Again.
    – Makoto
    Dec 5, 2017 at 17:05
6

Part of what made Stack Overflow docs great was that it was high profile—we're one of the most visited programming sites on the internet, so putting that link in the topbar can earn tons of views.

Putting it on GitHub just wouldn't get that kind of attention, and it's very possible that it would just sit there slowly going out of date.

Not the answer you're looking for? Browse other questions tagged .