Skip to main content
2 of 2
added 456 characters in body
user3743222
  • 18.6k
  • 11
  • 10

To decide whether it is a failed experiment, you need metrics. And those metrics have been exposed here (quoting from The dawn of Documentation: a solstice update):

Just this week, the executive team gave us a key metric for measuring success in the coming year: user growth.

It is pretty clear that whatever features SO Docs have, or resists keeping, is a result of the criteria imposed by the decision makers who drive the company.

Those decision makers' interests is supposed to go hand in hand with the interests of the community :

Obviously there’s a business reason for that goal, but it serendipitously benefits the quality of Documentation as well. As Eric Raymond notes, “Given enough eyeballs, all bugs are shallow.” Similarly, the more people who use Documentation to understand their code, learn a new feature or even answer questions on Stack Overflow, the more reliable the content will become.

You will find there some reasons behind why it is sought to maximize the number of contributors and their incentive to contribute (generate user growth through : attracting new users to the platform ; lowering the bar for existing users to create content, which also attract new users by network effect). This is supposed to be good for the community as more users is, according to the quote, linked to better quality.

What I think we have learnt for now is that volume of users (whether contributing users or just end users) does not really correlate with the quality of the documentation. Some might even argue the opposite. About the user growth side of the equation, I can't tell (nor do I care, though I understand they have to monetize their work (and ours) one way or another).

I think we should just stop caring. We don't own the company, they have all legitimacy to pursue any project they see fit, any way that they see fit. If we don't like a particular project, we should just focus on what we like and let them care about their own. And be grateful for the things that we indeed find useful.

user3743222
  • 18.6k
  • 11
  • 10