Re: proposal: convert comments in documents to html comments

From: Noboru Saito <noborusai(at)gmail(dot)com>
To: Peter Geoghegan <pg(at)bowt(dot)ie>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Michael Paquier <michael(at)paquier(dot)xyz>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: proposal: convert comments in documents to html comments
Date: 2022-06-27 05:13:54
Message-ID: CAAM3qnJDsT6y6t7KY=0VCtrG=uQtNuBdhiUk3vor530WbpPsFA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> I don't have much of a clue about our docbook toolchain, beyond the
> basics (plus I have no front-end experience). Is anybody else aware of
> a reasonable approach to making git hashes discoverable from the html
> release notes?

If you simply want to display it with a tooltip, the attached patch can do that.

I also attach html and css.
Please do not expect the quality of the css,
as it was created for the purpose of checking the operation.

2022年6月27日(月) 11:18 Peter Geoghegan <pg(at)bowt(dot)ie>:
>
> On Sun, Jun 26, 2022 at 6:02 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> > I seem to recall some discussion of letting the commit info pop up
> > as a tooltip. Not sure that that counts as "unobtrusive", though.
>
> I believe that I suggested this during the 2019 dev meeting at pgCon.
> This happened during a general discussion of the release note writing
> process.
>
> I don't have much of a clue about our docbook toolchain, beyond the
> basics (plus I have no front-end experience). Is anybody else aware of
> a reasonable approach to making git hashes discoverable from the html
> release notes?
>
> --
> Peter Geoghegan

Attachment Content-Type Size
release-15.html text/html 122.5 KB
tooltip.diff text/x-patch 1.3 KB
stylesheet.css text/css 3.2 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Laurenz Albe 2022-06-27 06:31:46 Remove recommendation for nightly VACUUM
Previous Message Peter Geoghegan 2022-06-27 02:18:08 Re: proposal: convert comments in documents to html comments