33

I answered a question here and referred to one article I contributed to documentation in the initial days. I got 5 rep as you can see from below screenshots:

enter image description here

enter image description here

Why do we need to get rep for referring to documentation? Can we take this back?

Update:
I voted myself on my article just randomly,but that was on day of documentation came live and i got a rep today

14
  • 2
    You also get a badge if you contributed to the linked docs
    – SeinopSys
    Aug 1, 2016 at 7:25
  • 3
    Are you sure that the +5 rep was for linking to documentation instead of an upvote to your example there?
    – Lamak
    Aug 1, 2016 at 16:28
  • @Lamak: I am 100% not sure,but as you can see that question has only one upvote and upvote in my article was mine when i wrote the article.I just upvoted to see how this works and i can upvote mine.To Clarify that upvote was done on same day when i wrote the article Aug 1, 2016 at 16:31
  • 1
    Your reputation tab lists this as topic cited (+5) and seemingly it has occured at the same time as the upvote on the answer. A similar thing occured to me, but there it was * example cited* and this hasn't occured to me after this incident. (I haven't checked though, if one of my upvoted answers was one with a link to one of my examples.)
    – fabian
    Aug 1, 2016 at 16:57
  • Related: Additional points for citing an example? Aug 1, 2016 at 22:05
  • @GertArnold At this point I think it would be better to close the other question as dupe of this one.
    – Siguza
    Aug 1, 2016 at 22:09
  • I would add bug to this
    – LinkBerest
    Aug 1, 2016 at 23:00
  • @JGreenwell I think you mean bug
    – DavidG
    Aug 1, 2016 at 23:08
  • @DavidG whoops, wrong tag shortcut - yeah I mean adding bug as this cannot be a desired behavior (+5 for own linked post not just for people referencing)
    – LinkBerest
    Aug 1, 2016 at 23:10
  • 1
    @JGreenwell Having said that, I don't think it's a bug, I'm pretty sure that's how it was intended to work. If anything, it's a feature request, but I think discussion is the best place to start.
    – DavidG
    Aug 1, 2016 at 23:11
  • 25
    its an incentive to link to our subpar docs instead of official docs. more rep for crap. yay!
    – Gordon
    Aug 2, 2016 at 6:31
  • 3
    @Gordon, I agree, linking to official documentation is a good practice, and we shouldn't have people do things instead of that. Aug 2, 2016 at 17:05
  • 1
    @SeinopSys You get a badge for linking to a Documentation topic you didn't contribute to, as well. 'Bluebook' for one you've contributed to, and 'Creditor' for one you haven't.
    – TylerH
    Aug 2, 2016 at 17:40
  • I agree with @Gordon, there shouldn't be any encouragement to choose unofficial doc over official.
    – Ivan
    Aug 4, 2016 at 3:07

1 Answer 1

3

At the moment, almost all Docs reputation comes from Example upvotes. That's not terribly surprising since:

  1. we haven't nerfed example upvote quite yet,
  2. early in the beta, many people decide to press the upvote button to see what it did,
  3. reputation from citations is somewhat restricted,
  4. most of the great Examples and Topics are yet to be written (knock on wood), and
  5. people haven't really gotten into the habit of citing Stack Overflow Documentation.

In the long run, however, I hope citation reputation actually catches up and even passes upvote reputation. One of the problems we are seeing is that it's hard to evaluate the usefulness of Documentation in the abstract. Remember how Jeff threatened a kitten because people weren't voting on questions?

Personally, I'm not convinced this problem is necessarily solvable, because it might represent the natural "market value" of questions and answers. Users intuit that answers are the real unit of work in any Q&A system and tend to favor answers in their voting. After all, the world is awash in endless questions, but answers—great answers—are a precious and rare commodity indeed.

Until it helps a real developer understand or get started with a topic, Documentation hasn't earned its salt. One of the fundamental problems I have when programming is finding the right bit of documentation quickly and without distraction. The other day, I forgot to how to zip a directory and looked it up in the manpage. In order to find a useful example, you gotta read past this line1:

zip [-aABcdDeEfFghjklLmoqrRSTuvVwXyz!@$] [--longoption ...] [-b path] [-n suffixes] [-t date] [-tt date] [zipfile [file ...]] [-xi list]

So when an answer that cites Documentation gets an upvote, it verifies that the Topic or Example was useful and encourages people to link to Documentation they contributed to. We think this will produce a virtuous circle where people improve answers by linking to relevant Documentation and improve Documentation in order use it in answers.

In the comments, I see some concern that we aren't encouraging linking to official documentation. People should link to official documentation whenever it makes an answer better. But (as with the zip command) sometimes you need something more exampley. Since you generally can't edit official documentation directly, there's no way to break into the virtuious cycle I described. So while I wouldn't be opposed2 to awarding reputation for citing all sorts of documentation, I don't think it would be nearly as useful as linking to Stack Overflow Documentation.


Footnotes:

  1. It would be quicker to list the ASCII characters that are not options. Manpages do a relatively good job at documenting things, but they can be really dense at times.

  2. In principle. In practice, I don't see how that would work given a seemingly endless supply of technologies.

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