Zsh Mailing List Archive Messages sorted by: Reverse Date, Date, Thread, Author

RE: Re: Modernizing Documentation format?

X-seq: zsh-workers 54131
From: zeurkous@xxxxxxxxxxxxxxx
To: dana <dana@xxxxxxx>, "Clinton Bunch" <cdb_zsh@xxxxxxxxxxx>
Cc: "zsh-workers@xxxxxxx" <zsh-workers@xxxxxxx>
Subject: RE: Re: Modernizing Documentation format?
Date: Sun, 07 Dec 2025 10:53:06 +0000 (UTC)
Archived-at: <https://zsh.org/workers/54131>
In-reply-to: <ce86f69a-4e5e-4b10-beac-d771d84ffdf6@app.fastmail.com>
List-id: <zsh-workers.zsh.org>
References: <e4e3aa29-4c05-4502-a152-b169b6f80d3e@zentaur.org> <ce86f69a-4e5e-4b10-beac-d771d84ffdf6@app.fastmail.com>

On Tue, 19 Aug 2025 14:40:50 -0500, dana <dana@xxxxxxx> wrote:
> imo rst's syntax is awful, but it's what everybody uses so oh well

Sorry, but that's not an "oh well", indeed it's the very crux of the
matter: bad syntax breeds sloppy documentation. It distracts the
writer's focus.

        --zeurkous.

-- 
Friggin' Machines!

References:
- Modernizing Documentation format?
  - From: Clinton Bunch
- Re: Modernizing Documentation format?
  - From: dana

Messages sorted by: Reverse Date, Date, Thread, Author