> On May 17, 2016, at 11:17 AM, Donald Allen <donaldcal...@gmail.com> wrote:
>
> My point is that good documentation is not
> easy to do, something I think many of us tend to forget. It's also
> less fun than writing code. Things like K&R that explain their subject
> so concisely and yet completely take tremendous skill. I myself am in
> the process of writing a document for a suite of personal financial
> management tools that I will release on github and I said to my wife
> the other day that writing the documentation is more difficult than
> writing the software.

Don,

I would agree with you 100%. I find that for my own software, the release
engineering (including writing and editing docs, taking screenshots, making
sure that the installer works correctly, making sure that the uninstaller
works correctly, testing on multiple systems with multiple configurations,
etc.) takes as much or more time than just writing the software. *Keeping* any
docs up to date (including screenshots and videos) is also a lot of work that
has to be factored in to update releases.


--Paul

[demime 1.01d removed an attachment of type application/pkcs7-signature which 
had a name of smime.p7s]

Reply via email to