Re: proposal: convert comments in documents to html comments - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: proposal: convert comments in documents to html comments
Date
Msg-id 20220627084839.5fuankjxgt6m62vv@alvherre.pgsql
Whole thread Raw
In response to Re: proposal: convert comments in documents to html comments  (Noboru Saito <noborusai@gmail.com>)
Responses Re: proposal: convert comments in documents to html comments
List pgsql-docs
On 2022-Jun-27, Noboru Saito wrote:

> > 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.

I like the idea of making the commits unobtrusively visible in the
output page.  This proposal looks a good step forward, but I'm sure we
can improve a little bit more.  For example, can we make the SHA1 hash
for each commit be a link to the gitweb page?  (Does this require
pattern matching in the XLST rule?)  Also, when there's more than one
commit in one entry, it'd be better to have them on separate lines
rather than run together in a single line.

Thanks!

-- 
Álvaro Herrera        Breisgau, Deutschland  —  https://www.EnterpriseDB.com/
"Linux transformó mi computadora, de una `máquina para hacer cosas',
en un aparato realmente entretenido, sobre el cual cada día aprendo
algo nuevo" (Jaime Salinas)



pgsql-docs by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: Remove recommendation for nightly VACUUM
Next
From: Laurenz Albe
Date:
Subject: Re: Remove recommendation for nightly VACUUM