1. People like me? :) I genuinely love writing documentation. Though I should mention it's easier to write books/tutorials than to write detailed documentation of the software you are yourself not writing, which brings me to point 2.
2. Writing documentation is very much a part of software-writing. It's usually best to do write documentation as you're writing the software... I haven't met anyone yet who really hated the process, so I wouldn't consider this to be a big problem at all.
It's no more strange that someone would enjoy writing documentation that it is that someone would enjoy writing software, though just as non-developers don't understand the joy of programming, I imagine that non-writers don't understand the joy of documenting.
So a question in return... Do you share my belief that documentation tends to lag in most projects? And if so, is the bottleneck not enough documentation writers, or not enough engineering time and attention? I've assumed it's the latter, though it could be the former. Or is it something else?
Absolutely.
I suspect that the number of people interested in writing software documentation is fairly small: they have to have enough knowledge of software engineering to be able to understand what they are writing about, and they have to be good writers. Anyone could learn software development, but not everyone does. And anyone could learn how to write well, but not everyone does. So the set of people who learn both is even smaller.
On commercial software engineering projects, my experience is that documentation of any sort is made as much of an afterthought as possible, if even that. Unless there's some business case (i.e., obvious money) that comes from spending time on documentation, then it doesn't make it very high on the priority list. Which is unfortunate, because as a software developer, I've wasted a lot of time figuring things out that should have been documented. So money can be saved later on, even if no money is "earned" up front.
For free / open source projects, the story may be different. There's not necessarily paid engineering staff involved, so if documentation doesn't get written, I can only presume that the developers either didn't want to, didn't know they should, or felt incapable of writing it. I find it hard to imagine taking a principled stand against having good documentation.
BUT... in my anecdotal experience, I've encountered volunteer open source software developers who in fact did seem resistant to accepting offers of volunteer help with documentation. So I'm not really sure what's up with that.
We've also seen further pushes to higher level languages, automated testing, improved version control systems, better and more accessible bug and feature tracking products that begin to take the place of official documentation or at least let it be automatically generated.
I also don't think we've reached the end of innovation in this area of self documenting code plus incentivized crowdsourced documentation. Slow incremental changes are eventually going to make that current help link at the top of your software app extinct, or at least look like a dinosaur compared to the elegant evolution that takes its place.
Now I'm not saying the current model in for-fee software is right. I just wonder, "If it's this hard when you're paying people to do it, how about when you're not?"
I hope to be proven wrong! :-) My company has a great tech write, but I live in fear of the day when someone buys one of his screenplays and he doesn't need us anymore...
The next Microsoft? That sounds like a nightmare.
No, thanks!
I've come around to broader thinking since then. And Microsoft has changed some too. But it has gotten harder to create companies from scratch due to restrictions on developer freedom. (Patents) There are other reasons that have made it easier, but those are tangential to RMS's topics.
2 - He didn't claim this explicitly. It was my interpretation of the results of everyone growing their own. I'm less convinced of this today.
When I first heard him speak many years ago, I thought he was a real crank. My negative thoughts centered around:
1 - How can we build the next Microsoft without true ownership?
2 - Does his model of thinking demand that 100% of the population be technical enough to troubleshoot their computers?
3 - I can see people writing software for love, but who writes all the documentation?
As the years go by, he's one of the few people who sounds less like a crackpot, even though he hasn't softened his extremism. With the current state of patent trolling, it's getting harder to create the next Microsoft. Improvements in GUIs is taking some of the issue away for #2. But I still haven't figured out #3.
Edited for formatting