[TUHS] On Bloat and the Idea of Small Specialized Tools

Adam Thornton athornton at gmail.com
Mon May 20 16:07:37 AEST 2024


I can't tell you--although some of you will know--what a delight it is to
be working on a project with an actual documentation engineer.

That person (Jonathan Sick, if any of you want to hire him) has engineered
things such that it is easy to write good documentation for the projects we
write, and not very onerous.

He's put in an enormous amount of effort to ensure that if we write
reasonably clean code, we can also auto-generate accurate and complete API
documentation for it.  And to the degree we want to write explanatory docs,
that's catered for too.

It has been an amazing experience compared to my entire prior history.

Adam
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.tuhs.org/pipermail/tuhs/attachments/20240519/54cfda86/attachment.htm>


More information about the TUHS mailing list