From: Adam Thornton <athornton@gmail.com>
To: The Eunuchs Hysterical Society <tuhs@tuhs.org>
Subject: [TUHS] Re: On Bloat and the Idea of Small Specialized Tools
Date: Sun, 19 May 2024 23:07:37 -0700 [thread overview]
Message-ID: <CAP2nic07dtEUjgC4Ex8g0iOaDuGsXyhTxY23v0x8wG_cb3D_+A@mail.gmail.com> (raw)
In-Reply-To: <CAOkr1zUeW9cMt=Dk+bXbRtCkh=m7bZtkKNaqO8zF43kxt6V+ww@mail.gmail.com>
[-- Attachment #1: Type: text/plain, Size: 640 bytes --]
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
[-- Attachment #2: Type: text/html, Size: 786 bytes --]
next prev parent reply other threads:[~2024-05-20 6:08 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-05-18 18:07 Douglas McIlroy
2024-05-18 18:13 ` Brantley Coile
2024-05-18 18:18 ` Larry McVoy
2024-05-18 18:52 ` Clem Cole
2024-05-18 19:19 ` Luther Johnson
2024-05-18 20:12 ` segaloco via TUHS
2024-05-18 19:32 ` Stuff Received
2024-05-18 18:22 ` Ralph Corderoy
2024-05-19 8:58 ` [TUHS] The 'usage: ...' message. (Was: On Bloat...) Ralph Corderoy
2024-05-18 18:31 ` [TUHS] Re: On Bloat and the Idea of Small Specialized Tools Peter Weinberger (温博格) via TUHS
2024-05-18 20:33 ` Steffen Nurpmeso
2024-05-19 8:39 ` Marc Rochkind
2024-05-20 6:07 ` Adam Thornton [this message]
2024-05-20 15:43 ` [TUHS] Documentation (was On Bloat and the Idea of Small Specialized Tools) Paul Winalski
2024-05-20 16:37 ` [TUHS] " Andrew Hume
2024-05-20 18:38 ` Yeechang Lee
2024-05-20 19:27 ` Phil Budne
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAP2nic07dtEUjgC4Ex8g0iOaDuGsXyhTxY23v0x8wG_cb3D_+A@mail.gmail.com \
--to=athornton@gmail.com \
--cc=tuhs@tuhs.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).