Re: proposal: convert comments in documents to html comments

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Noboru Saito <noborusai(at)gmail(dot)com>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Peter Geoghegan <pg(at)bowt(dot)ie>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: proposal: convert comments in documents to html comments
Date: 2022-06-28 03:55:58
Message-ID: Yrp7zoI2aKpUxqu8@paquier.xyz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Jun 28, 2022 at 12:42:08PM +0900, Noboru Saito wrote:
> If you want to separate hashes or add links,
> I think it would be better to stop the current comment and make it a paragraph
> (I think it is possible to keep them folded
> when converted to html even if they are paragraphs).
> I agree with doing it that way, but it may not be possible right away.

Hmm. Could it be better to tweak git_changelog so as the commit ID is
reordered in the contents generated then? Then the doc rules could be
tweaked to feed on that? I have noticed that your patch is not able
to put a commit with its correct item. The first item of a section is
not aligned looks associated to nothing, while the last item has no
commit associated to it.
--
Michael

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Noboru Saito 2022-06-29 07:29:23 Re: proposal: convert comments in documents to html comments
Previous Message Noboru Saito 2022-06-28 03:42:08 Re: proposal: convert comments in documents to html comments