On 7. 10. 2026 18:50, Branko Čibej wrote:
On 7. 10. 2026 18:35, Nathan Hartman wrote:
On Wed, Oct 7, 2026 at 12:08 PM Branko Čibej <[email protected]> wrote:
On 7. 10. 2026 16:12, Daniel Sahlberg wrote:
Den ons 7 okt. 2026 kl 16:05 skrev Evgeny Kotkov via dev
<[email protected]> <mailto:[email protected]>:
Hi all,
While skimming the latest version of the 1.15 release notes [1], I almost
missed the new "Build System Comparison" table because it is collapsed
inside a <details> element.
I'd like to propose dropping the <details> and showing the table inline,
for a few reasons:
- This collapsed content is easy to miss entirely, because the summary line
doesn't look like something clickable with the default styling.
- I think that the table looks great and enhances the release notes, so we
should not hide it.
- The current "Build System Comparison > Build System Comparison" hierarchy
reads oddly.
- I think the release notes aren't long enough to justify collapsing
sections.
Would there be any objections to me committing an ad-hoc patch that removes
the <details> block for this table?
I'm fine with either approach. There was a wish to keep the notes a
bit shorter (see quoted text in [2]) but it adds 10% to something
people would probably not print either way.
My main gripe about that collapsed table is that it's so
amazingly subtle that no-one who doesn't know its there will find
it. The default styling is moderately horrible, using one little
widget that no-one will notice is a great example of a UI hiding
functionality in plain sight.
So it's either: remove the <detail> wrapper or fix the styling. I
could have a go at the latter, I see it as behaving similarly to
a link.
-- Brane
I'm +1 to remove it and make the table always visible, but if you
think a properly styled detail tag will have other uses throughout
the site, feel free to experiment with it. I experimented a bit back
when it was added (possibly by me?) and just got frustrated with it
and gave up. Currently AFAIK it is used in only this one place, so
it's only worth messing with it if we want to use it elsewhere too.
Committed an example to the staging site on r1938868. It's so simple
that I don't know why we didn't just do it from day one.
file:///Users/brane/src/svn/repos/site/staging/docs/release-notes/1.15.html#build-system-comparison
What an amazingly relevant link I just posted ... Of course it's
https://subversion-staging.apache.org/docs/release-notes/1.15.html#build-system-comparison
-- Brane
