This article got me thinking about the fundamental paradox in our industry - we all desperately need good documentation, but most of us hate creating it. The piece talks about making docs “less boring” through better design and structure, but I’m more curious about the underlying problem: is the pain of writing documentation actually worth solving, or do most developers just accept it as a necessary evil? In my experience, there are roughly three camps: 1. The sufferers - Write docs because they have to, hate every minute of it 2. The skippers - Just don’t document and hope someone else deals with it later 3. The rare unicorns - Actually enjoy writing documentation (do these people exist?) What’s your honest approach? Do you: • Power through the tedium because you know it’s important? • Use any tools/automation to make it less painful? • Just… not do it unless absolutely forced? I’m particularly interested in whether people think this is a problem worth solving with better tooling, or if it’s just an inherent part of development that we need to accept.
💬 Discussion r/programming (59 points, 27 commentaires) 🔗 Source