confusing styling and layout of help page with figures
The page https://docs.gimp.org/2.10/en/gimp-tutorial-quickie-separate.html describes different tools to select the foreground. It has a nice header line for each tool, followed by helpful images of the chosen tool in the toolbox and its appearance in an image, followed by some text explaining the tool. Perfect?!
BUT, the text is actually a description of the tool used in the next figure. This makes the page really hard to read. The core problem is that in the absence of an actual h4 heading for each tool, the figure captions look exactly like headings, so they organize the page into sections incorrectly.
The style of the figure caption is very misleading. Normally figure captions appear below the figure in an indented centered paragraph in a small and/or italic font; see for example, WordPress figure caption styling, multiple style guides, the W3C's sample layout for figures & captions, etc. Instead, the Gimp documentation's p.title
style is right-aligned with a full-width bottom rule; I think it gets this appearance from CSS it shares with h3,h4,h5 – no wonder it looks like a heading! True, the figure div has a border around it that hints that this heading only applies to the figure, but the full-width rule still divides up the page wrong.
I think with CSS rules for div.figure > p.title
you can present figure captions styled conventionally without changing the existing HTML. Even putting the caption below the figure is apparently doable in CSS without reorganizing the HTML. Long-term you should consider using HTML5 figure and figcaption tags.
If you're not going to change figure caption styling, a workaround to reduce confusion on this page is to add an h4 heading at the start of each section that has a figure. You wind up with lots of section lines, but it's comprehensible.
This is literally the first page of Gimp 2.10 documentation I've read, so I apologize if I'm missing a bigger picture. Thanks for the excellent documentation content.