Skip to main content
added 180 characters in body
Source Link
JDB
  • 25.8k
  • 2
  • 43
  • 65

How do I earn reputation with topics? Will my "answer" get upvotes?

Answers to Q&A questions often overlap one anotherOn second look, and the most thorough and correct answer tends to be get the most upvotes. But that doesn't meanit seems that the most upvoted question contains all of the information needed by everyone. This is already an issue with some very specific questions, andreputation will only be compounded by the very "general" nature of a "topic". It'd more important than ever for the community to collaborate and create a single source of truth, like a wiki answer,earned via "contributions" rather than 30 answers that mostly repeat one another, forcing visitors to read through many posts to find their use-case.

But users don't earn reputation from wiki answers.

So back to the question Sounds interesting... how do I earn reputation? And if I don't, then why am I spending time working on documentation when I could be getting rep (and warm fuzzies) by answer questions?can't wait to hear more details.

How do I earn reputation with topics? Will my "answer" get upvotes?

Answers to Q&A questions often overlap one another, and the most thorough and correct answer tends to be get the most upvotes. But that doesn't mean that the most upvoted question contains all of the information needed by everyone. This is already an issue with some very specific questions, and will only be compounded by the very "general" nature of a "topic". It'd more important than ever for the community to collaborate and create a single source of truth, like a wiki answer, rather than 30 answers that mostly repeat one another, forcing visitors to read through many posts to find their use-case.

But users don't earn reputation from wiki answers.

So back to the question... how do I earn reputation? And if I don't, then why am I spending time working on documentation when I could be getting rep (and warm fuzzies) by answering questions?

How do I earn reputation with topics? Will my "answer" get upvotes?

Answers to Q&A questions often overlap one another, and the most thorough and correct answer tends to be get the most upvotes. But that doesn't mean that the most upvoted question contains all of the information needed by everyone. This is already an issue with some very specific questions, and will only be compounded by the very "general" nature of a "topic". It'd more important than ever for the community to collaborate and create a single source of truth, like a wiki answer, rather than 30 answers that mostly repeat one another, forcing visitors to read through many posts to find their use-case.

But users don't earn reputation from wiki answers.

So back to the question... how do I earn reputation? And if I don't, then why am I spending time working on documentation when I could be getting rep (and warm fuzzies) by answer questions?

On second look, it seems that reputation will be earned via "contributions" rather than posts. Sounds interesting... can't wait to hear more details.

How do I earn reputation with topics? Will my "answer" get upvotes?

Answers to Q&A questions often overlap one another, and the most thorough and correct answer tends to be get the most upvotes. But that doesn't mean that the most upvoted question contains all of the information needed by everyone. This is already an issue with some very specific questions, and will only be compounded by the very "general" nature of a "topic". It'd more important than ever for the community to collaborate and create a single source of truth, like a wiki answer, rather than 30 answers that mostly repeat one another, forcing visitors to read through many posts to find their use-case.

But users don't earn reputation from wiki answers.

So back to the question... how do I earn reputation? And if I don't, then why am I spending time working on documentation when I could be getting rep (and warm fuzzies) by answering questions?

Source Link
JDB
  • 25.8k
  • 2
  • 43
  • 65

This is a really exciting idea.

But I have a few concerns:

  • "Versions" are Arbitrary

.NET has major releases, but that doesn't necessarily mean that the individual libraries within the product follow those version numbers.

For example, .NET 4.5.1 was rolled out fairly recently, but the "Product Version" of the Accessibility.DLL file is 4.0.30319.18020. Meanwhile, on MSDN, the documentation for versions 4.5 and 4.6 of the Accessibility namespace are lumped together, though the URL shows version 110.

So which version number is correct? Only the authors of the library can truly understand the significance behind a "version" and how that impacts individual parts of a system.

And then there's open source projects and their many branches and forks. How does one keep track of version numbers in such messy situations?

  • Not all documentation can be neatly tucked under one heading

The best documentation provides broad overviews and then connects the dots between different parts of the API. Documenting functions and parameters will only ever cover a small part of an API's functionality.

Recently I tried to wrap my head around OAuth. While the individual query parameters were pretty well documented, what I really needed was a detailed overview of the flow for my particular (uncommon) scenario.

Looking at .NET again, there are some libraries that overlap one another. I depend on documentation to explain the differences between the libraries and to help me determine which fits my needs. It's just shades of gray from that to a comparison of VB, C#, C++ and F#.

Would this fit under SO's documentation? Just imagine the battles between those who say "yes" and those who say "no". It's uncharted territory and it's going to get ugly before it gets better.

  • Does SO want to be everyone's documentation host?

Already a lot of major technologies point developer to Stack Overflow to get their questions answered (in lieu of a standard community):

enter image description here

Do we also want projects to abandon their own documentation platforms and move everything to SO? A lot of those documentation platforms cost a pretty penny (if not the CMS, then the hosting and bandwidth), so the idea of a completely free documentation host where the community will help you out (so you can downsize your documentation team) would be very tempting. Do we want that?

  • RTFM just got more complicated

Is documentation going to be a separate resource from Q&A? If someone asks a very specific question that's already covered in the more general documentation, will it be closed as a duplicate?

  • Incentives are important

How do I earn reputation with topics? Will my "answer" get upvotes?

Answers to Q&A questions often overlap one another, and the most thorough and correct answer tends to be get the most upvotes. But that doesn't mean that the most upvoted question contains all of the information needed by everyone. This is already an issue with some very specific questions, and will only be compounded by the very "general" nature of a "topic". It'd more important than ever for the community to collaborate and create a single source of truth, like a wiki answer, rather than 30 answers that mostly repeat one another, forcing visitors to read through many posts to find their use-case.

But users don't earn reputation from wiki answers.

So back to the question... how do I earn reputation? And if I don't, then why am I spending time working on documentation when I could be getting rep (and warm fuzzies) by answer questions?