Skip to main content
Active reading. [ <https://en.wiktionary.org/wiki/bare-bones#Adjective> <http://en.wiktionary.org/wiki/Wikipedia#Proper_noun> <https://en.wiktionary.org/wiki/overengineered#Adjective>].
Source Link
Peter Mortensen
  • 31.6k
  • 4
  • 22
  • 14

Why not set up a barebonebare-bones wiki as it was initalinitial inspiration of documentation as said in The dawn of Documentation: a solstice updateThe dawn of Documentation: a solstice update?

I explain afterAfter the why, I explain a simpler model that might have workworked and why this modern lone did not.

My experience comecomes from being an old contributor of wikipediato Wikipedia.

I found the experience of a technical writer of other wiki documentation cited in comments irrelevant because if I understand well why the scope of such a wiki is different: itIt is usually a single project wiki, and it hasdoes not have the critical mass of contributorcontributors.

The second point is that it seems that instead of start of the simplest model which can work (a bare bone-bones wiki) and develop around it according to the needs which araisedarised from here, you have developed an overengenereeoverengineered model in the hope it will fit. From my experience, the way that the documentation is single centered around example fit to some of subjectthe subjects, but not all.

The third point of failure comparing to wikipediaWikipedia is that by wantedwanting the contribution systematically peer reviewed and moreovemoreover by several peerpeers you lost immediate feedback for new users.

The fourth point is that you had absolutely wanted to set a reputation system which overconstrained your system. As much it reasonably workworks together with single contribution document authorauthors such as qaQ&A it is hard to work with multiple authorauthors. It leads you to have a confirmation system to be sure that people will not game the system. The motivation behind wikipedia contributorWikipedia contributors is as long as I can analyze it is mainly to act for the general good.

Why not set up a barebone wiki as it was inital inspiration of documentation as said in The dawn of Documentation: a solstice update

I explain after the why a simpler model might have work and this modern l did not.

My experience come from being an old contributor of wikipedia.

I found the experience of technical writer of other wiki documentation cited in comments irrelevant because if I understand well the scope of such wiki is different: it is usually a single project wiki and it has not the critical mass of contributor.

The second point is that it seems that instead of start of the simplest model which can work (a bare bone wiki) and develop around it according to the needs which araised from here, you have developed an overengeneree model in the hope it will fit. From my experience, the way that the documentation is single centered around example fit to some of subject but not all.

The third point of failure comparing to wikipedia is that by wanted the contribution systematically peer reviewed and moreove by several peer you lost immediate feedback for new users.

The fourth point is that you had absolutely wanted to set a reputation system which overconstrained your system. As much it reasonably work together with single contribution document author such as qa it is hard to work with multiple author. It leads you to have confirmation system to be sure that people will not game the system. The motivation behind wikipedia contributor is as long as I can analyze is mainly to act for the general good.

Why not set up a bare-bones wiki as it was initial inspiration of documentation as said in The dawn of Documentation: a solstice update?

After the why, I explain a simpler model that might have worked and why this modern one did not.

My experience comes from being an old contributor to Wikipedia.

I found the experience of a technical writer of other wiki documentation cited in comments irrelevant because if I understand well why the scope of such a wiki is different: It is usually a single project wiki, and it does not have the critical mass of contributors.

The second point is that it seems that instead of start of the simplest model which can work (a bare-bones wiki) and develop around it according to the needs which arised from here, you have developed an overengineered model in the hope it will fit. From my experience, the way that the documentation is single centered around example fit to some of the subjects, but not all.

The third point of failure comparing to Wikipedia is that by wanting the contribution systematically peer reviewed and moreover by several peers you lost immediate feedback for new users.

The fourth point is that you had absolutely wanted to set a reputation system which overconstrained your system. As much it reasonably works together with single contribution document authors such as Q&A it is hard to work with multiple authors. It leads you to have a confirmation system to be sure that people will not game the system. The motivation behind Wikipedia contributors is as long as I can analyze it is mainly to act for the general good.

Explanation why a wiki might succeed while documentation did not
Source Link

Why not set up a barebone wiki as it was inital inspiration of documentation as said in The dawn of Documentation: a solstice update

I explain after the why a simpler model might have work and this modern l did not.

My experience come from being an old contributor of wikipedia.

I found the experience of technical writer of other wiki documentation cited in comments irrelevant because if I understand well the scope of such wiki is different: it is usually a single project wiki and it has not the critical mass of contributor.

The second point is that it seems that instead of start of the simplest model which can work (a bare bone wiki) and develop around it according to the needs which araised from here, you have developed an overengeneree model in the hope it will fit. From my experience, the way that the documentation is single centered around example fit to some of subject but not all.

The third point of failure comparing to wikipedia is that by wanted the contribution systematically peer reviewed and moreove by several peer you lost immediate feedback for new users.

The fourth point is that you had absolutely wanted to set a reputation system which overconstrained your system. As much it reasonably work together with single contribution document author such as qa it is hard to work with multiple author. It leads you to have confirmation system to be sure that people will not game the system. The motivation behind wikipedia contributor is as long as I can analyze is mainly to act for the general good.

Why not set up a barebone wiki as it was inital inspiration of documentation as said in The dawn of Documentation: a solstice update

Why not set up a barebone wiki as it was inital inspiration of documentation as said in The dawn of Documentation: a solstice update

I explain after the why a simpler model might have work and this modern l did not.

My experience come from being an old contributor of wikipedia.

I found the experience of technical writer of other wiki documentation cited in comments irrelevant because if I understand well the scope of such wiki is different: it is usually a single project wiki and it has not the critical mass of contributor.

The second point is that it seems that instead of start of the simplest model which can work (a bare bone wiki) and develop around it according to the needs which araised from here, you have developed an overengeneree model in the hope it will fit. From my experience, the way that the documentation is single centered around example fit to some of subject but not all.

The third point of failure comparing to wikipedia is that by wanted the contribution systematically peer reviewed and moreove by several peer you lost immediate feedback for new users.

The fourth point is that you had absolutely wanted to set a reputation system which overconstrained your system. As much it reasonably work together with single contribution document author such as qa it is hard to work with multiple author. It leads you to have confirmation system to be sure that people will not game the system. The motivation behind wikipedia contributor is as long as I can analyze is mainly to act for the general good.

Source Link

Why not set up a barebone wiki as it was inital inspiration of documentation as said in The dawn of Documentation: a solstice update