From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 30183 invoked from network); 1 Sep 2020 10:11:18 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 1 Sep 2020 10:11:18 -0000 Received: (qmail 15133 invoked by uid 89); 1 Sep 2020 10:11:42 -0000 Mailing-List: contact supervision-help@list.skarnet.org; run by ezmlm Sender: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Received: (qmail 15126 invoked from network); 1 Sep 2020 10:11:41 -0000 From: "Laurent Bercot" To: supervision@list.skarnet.org Subject: Re: [request for review] Port of s6 documentation to mdoc(7) Date: Tue, 01 Sep 2020 10:11:14 +0000 Message-Id: In-Reply-To: <20200901063801.GA2158@caspervector> References: <877dtgtu1z.fsf@ada> <20200831160811.6zqdbyjyzk4bembt@mail.imca-cat.org> <20200831191433.wbjh6wltyqhdv5hl@mail.imca-cat.org> <20200901063801.GA2158@caspervector> Reply-To: "Laurent Bercot" User-Agent: eM_Client/8.0.3385.0 Mime-Version: 1.0 Content-Type: text/plain; format=flowed; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-VR-SPAMSTATE: OK X-VR-SPAMSCORE: 0 X-VR-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgeduiedrudefjedgvdehucetufdoteggodftvfcurfhrohhfihhlvgemucfpfgfogfftkfevteeunffgpdfqfgfvnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfgjfhhrfgggtgfgsehtqhertddtreejnecuhfhrohhmpedfnfgruhhrvghnthcuuegvrhgtohhtfdcuoehskhgrqdhsuhhpvghrvhhishhiohhnsehskhgrrhhnvghtrdhorhhgqeenucggtffrrghtthgvrhhnpedtfeekueetieektefhveeuveevtdekgeefhfeutedvieeiheduueeiudehvdetveenucffohhmrghinhepshhkrghrnhgvthdrohhrghenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhhouggvpehsmhhtphhouhht > >* We negotiate a HTML schema your documentation can be written in, which > is based on current documentation; existing HTML documentation will be > converted to the schema, with minimised changes. (The structuredness > of HTML helps; now you also see why knowing some Lisp is beneficial :) I'm totally willing to use a HTML schema we can negotiate, to write future documentation in. What I don't want to do is: - Touch existing documentation, unless I have to rewrite the content of a page for some reason. Of course, if the conversion work is done by somebody else, I have no objection to upstreaming the new documents. - Add heavy dependencies to the skarnet.org Makefiles. But honestly, if I'm going to change the way I write doc, I'd rather write scdoc, which is simpler than plain HTML especially if we're adding a lot of semantic tags to that HTML. To me, the best thing would be if someone would add a HTML backend to scdoc. I may do it myself if I need a break from interesting service management stuff and experience an irresistible urge to work on HTML generation instead. The odds are what they are. -- Laurent