From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,HTML_MESSAGE,MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: from minnie.tuhs.org (minnie.tuhs.org [IPv6:2600:3c01:e000:146::1]) by inbox.vuxu.org (Postfix) with ESMTP id F067E264EF for ; Mon, 20 May 2024 08:08:04 +0200 (CEST) Received: from minnie.tuhs.org (localhost [IPv6:::1]) by minnie.tuhs.org (Postfix) with ESMTP id 7E18443AD0; Mon, 20 May 2024 16:07:58 +1000 (AEST) Received: from mail-ed1-x52c.google.com (mail-ed1-x52c.google.com [IPv6:2a00:1450:4864:20::52c]) by minnie.tuhs.org (Postfix) with ESMTPS id 2C5C643AC6 for ; Mon, 20 May 2024 16:07:51 +1000 (AEST) Received: by mail-ed1-x52c.google.com with SMTP id 4fb4d7f45d1cf-574f7c0bab4so8619336a12.0 for ; Sun, 19 May 2024 23:07:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1716185269; x=1716790069; darn=tuhs.org; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=dxpWnGPIqSreJ/CqLkrkuI6PanPrnEiGfHMBdlNPeXA=; b=Z+XSp12Z85JweKyrzDS2lGCDT2OILiR610vA4vd8lw9kkbtpdVnEDLfB1sieCP9fl6 OL2r8TYcWBlcLqrYm+B/RUUOvqS/SxK6cKKC9b9AFRAXoy0S01B5fBFRg7oMKAfnY+Sy 2BVdzs4zSzZxq7tMs+sTCcWzVeiXAPsLHLw0gGFFTWUQ1fyH7q6y4XNxERt6gLektqyN oVAlmXzRjbDYPgLO5y5Lq7qFadRBQOUa4a9RN9C/80HJzuXfAKXKuuba3y0FuPTj7OAR g15cnysAWYi81mH7gU1ICjiCREMxa+B0cbBQH+2kO9N4a8EkTEPwJSs8KCd8FTtfM3jH WVlg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1716185269; x=1716790069; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=dxpWnGPIqSreJ/CqLkrkuI6PanPrnEiGfHMBdlNPeXA=; b=NB0WsZWvMfRi+evsun6BXmxUuzMcuprzAMO7lTNlZBfJOGPHRAq6T2h2Kcq03YV20c Yd774jzW1bJFTvi3JLvINtqVHCW/UkLzfh71cr8lFmm9SGSvkWA/vzYOjbQdvGJlKTF2 9I0GsrUZVSXWDHs8l1ty5fCClWvvjrBfXRZoPf76si12+2Qarv27BeNB0Yi924Z2asu6 IQ8Hcht7aDa7e8GTxBBgoS/SCdyt8oWRnoyXAsQkene5B8dO8JHKbecCyPodRBJIIPTB ihP915U23gRKOZ8jZn4/I61FLBXjPRZ+ptJoQhTpz0Zjt8DNC2+iz+QtT7PqLBFBZ0Az WBrw== X-Gm-Message-State: AOJu0YwDYXyuUqTp2e+1JG4EWQryX27S5YhKedKGdQFHjIqCT0zWAzWp 57SGds7l49PezQqlBo7XmO5d6Hw+ltq9tGCr0/prAONSnRBNjXKLCWMXr3ZSVSnOn8pfpVUEQXi HY9rhHm4NEWT3e4145axGx5bYKVoefQ== X-Google-Smtp-Source: AGHT+IF1bH6+K2vf96BoyVmVQdbly/hk14Mlb1tRXafFVZPAi5onBxOus5wC2GEG9KZcrX52pw5LxRDrD8Y0v3N8XFU= X-Received: by 2002:a50:8a91:0:b0:571:bf62:81ce with SMTP id 4fb4d7f45d1cf-5752b47fe5fmr4137274a12.9.1716185268772; Sun, 19 May 2024 23:07:48 -0700 (PDT) MIME-Version: 1.0 References: <20240518203319.3oAKtOSk@steffen%sdaoden.eu> In-Reply-To: From: Adam Thornton Date: Sun, 19 May 2024 23:07:37 -0700 Message-ID: To: The Eunuchs Hysterical Society Content-Type: multipart/alternative; boundary="0000000000005066430618dc851b" Message-ID-Hash: TD2B7RVYQB2R4AI4Q7KXWGASGKVMCCVA X-Message-ID-Hash: TD2B7RVYQB2R4AI4Q7KXWGASGKVMCCVA X-MailFrom: athornton@gmail.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.6b1 Precedence: list Subject: [TUHS] Re: On Bloat and the Idea of Small Specialized Tools List-Id: The Unix Heritage Society mailing list Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: --0000000000005066430618dc851b Content-Type: text/plain; charset="UTF-8" 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 --0000000000005066430618dc851b Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
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 documentati= on 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 th= at if we write reasonably clean code, we can also auto-generate accurate an= d complete API documentation for it.=C2=A0 And to the degree we want to wri= te explanatory docs, that's catered for too.

I= t has been an amazing experience compared to my entire prior history.
=

Adam
--0000000000005066430618dc851b--