Skip to main content
Copy edited (e.g. ref. <http://english.stackexchange.com/questions/4645/is-it-ever-correct-to-have-a-space-before-a-question-or-exclamation-mark#comment206109_4645>), etc.
Source Link
Peter Mortensen
  • 31.6k
  • 4
  • 22
  • 14

JustI just wanted to share how I envision a stackoverflowStack Overflow documentation.

How to contribute to a documentation topic?

Everything about stackoverflowStack Overflow is questions / answers, and it's great. Why not use the same thing for documentation?

CommunityThe community answer nearly got it right, except for the fact that it suppressed all the reputation... With a little tweak it could be great. For example, let's say that you have a topic that you want documentation on, you would do  :

  1. Create a documentation topic  : likeLike a normal question except that the documentation result will be put in the question body
  2. Let people answer this question like they would do normally and earn reputation for their answer.
  3. Then take all the good part in the answers provided and build the documentation answer (directly in the question body)

Just take a moment to consider how hard it is to contribute to an unknown tag with the current documentation system compare to this one above. You could now start a topic about anything, a good topic would receive points and a bad topic would fall into oblivion, exactly like QAQ&A.

Next you need organization

Being able to start a documentation topic about anything is a great start, but to get something useful you need to be able to organize them. Whether I want to build a quick tutorial or a reference manual, I will need a way to organize the topics in a logical order.

The current system is very lacking on that front. We need to be able to organize the topics how we want. It could be as simple as a side menu for all the topics that are linked together.

So, a "documentation" would just be a group of ordered documentation topictopics, and you could create many "documentations" to address many different needs.

Just wanted to share how I envision a stackoverflow documentation.

How to contribute to a documentation topic?

Everything about stackoverflow is questions / answers and it's great. Why not use the same thing for documentation?

Community answer nearly got it right, except for the fact that it suppressed all the reputation... With a little tweak it could be great. For example, let's say that you have a topic that you want documentation on, you would do  :

  1. Create a documentation topic  : like a normal question except that the documentation result will be put in the question body
  2. Let people answer this question like they would do normally and earn reputation for their answer.
  3. Then take all the good part in the answers provided and build the documentation answer (directly in the question body)

Just take a moment to consider how hard it is to contribute to an unknown tag with the current documentation system compare to this one above. You could now start topic about anything, good topic would receive points and bad topic would fall into oblivion, exactly like QA.

Next you need organization

Being able to start a documentation topic about anything is a great start but to get something useful you need to be able to organize them. Whether I want to build a quick tutorial or a reference manual, I will need a way to organize the topics in a logical order.

The current system is very lacking on that front. We need to be able to organize the topics how we want. It could be as simple as a side menu for all the topics that are linked together.

So, a "documentation" would just be a group of ordered documentation topic and you could create many "documentations" to address many different needs.

I just wanted to share how I envision Stack Overflow documentation.

How to contribute to a documentation topic?

Everything about Stack Overflow is questions / answers, and it's great. Why not use the same thing for documentation?

The community answer nearly got it right, except for the fact that it suppressed all the reputation... With a little tweak it could be great. For example, let's say that you have a topic that you want documentation on, you would do:

  1. Create a documentation topic: Like a normal question except that the documentation result will be put in the question body
  2. Let people answer this question like they would do normally and earn reputation for their answer.
  3. Then take all the good part in the answers provided and build the documentation answer (directly in the question body)

Just take a moment to consider how hard it is to contribute to an unknown tag with the current documentation system compare to this one above. You could now start a topic about anything, a good topic would receive points and a bad topic would fall into oblivion, exactly like Q&A.

Next you need organization

Being able to start a documentation topic about anything is a great start, but to get something useful you need to be able to organize them. Whether I want to build a quick tutorial or a reference manual, I will need a way to organize the topics in a logical order.

The current system is very lacking on that front. We need to be able to organize the topics how we want. It could be as simple as a side menu for all the topics that are linked together.

So, "documentation" would just be a group of ordered documentation topics, and you could create many "documentations" to address many different needs.

Source Link
Gudradain
  • 4.7k
  • 12
  • 8

Just wanted to share how I envision a stackoverflow documentation.

How to contribute to a documentation topic?

Everything about stackoverflow is questions / answers and it's great. Why not use the same thing for documentation?

Community answer nearly got it right, except for the fact that it suppressed all the reputation... With a little tweak it could be great. For example, let's say that you have a topic that you want documentation on, you would do :

  1. Create a documentation topic : like a normal question except that the documentation result will be put in the question body
  2. Let people answer this question like they would do normally and earn reputation for their answer.
  3. Then take all the good part in the answers provided and build the documentation answer (directly in the question body)

Just take a moment to consider how hard it is to contribute to an unknown tag with the current documentation system compare to this one above. You could now start topic about anything, good topic would receive points and bad topic would fall into oblivion, exactly like QA.

Next you need organization

Being able to start a documentation topic about anything is a great start but to get something useful you need to be able to organize them. Whether I want to build a quick tutorial or a reference manual, I will need a way to organize the topics in a logical order.

The current system is very lacking on that front. We need to be able to organize the topics how we want. It could be as simple as a side menu for all the topics that are linked together.

So, a "documentation" would just be a group of ordered documentation topic and you could create many "documentations" to address many different needs.