3 ms·
That's happening already. To be more specific, any ideas on getting developers engaged in creating "quality" docs? They don't really care about them right now,
by jenncarlos 11y ago
That's happening already. To be more specific, any ideas on getting developers engaged in creating "quality" docs? They don't really care about them right now, its just a necessary administrative step on the path to commit.
- achamayou 11y agoWhen developers happen to be doing user support on the mailing list/forum/whatever you use, the importance of writing quality technical doc becomes more readily apparent to them. The volume of questions diminishes as the doc improves, they become more interesting, and you can get the simple ones out of the way by sending a link without remorse because you know it does contain exactly what the user was looking for. Of course it takes a little while for this to really engage, you'll need to kick a few people in the bottom to get past the initial investment, but in my experience it definitely works.
- dandelany 11y agoStart enforcing. Make PR's required for all new code, and reject PR's which aren't well-documented. Most developers can write good docs, they (we) just tend not to, until docs are treated as a primary priority by the rest of the team.
- TheOtherHobbes 11y agoThere will be mutinous grumbling. But yes - this. Good docs are in everyone's interest. It's hard enough for insiders to maintain code that isn't documented properly. Worse, it's nearly impossible for outsiders to come in and make changes later - at least not without a lot of wasted time.