Created attachment 616762 [details] screenshot It seems that the list in 'Eclass Reference' embraces the horrible idea of using an inline element to build a list and turning it to block element via CSS. As a result, the eclass list is a wall-of-text soup in text browsers:
This is a bug (or feature?) of Bootstrap list groups: https://getbootstrap.com/docs/3.3/components/#list-group You'll see the same rendering on other sites, e.g., https://infra-status.gentoo.org/. I don't think there's anything we can do about it (other than changing the list into a regular <ul>). CCing www: Should this be reported to Bootstrap upstream?
Created attachment 616774 [details] listgroup fix (webview)
Created attachment 616776 [details] listgroup fix (textview)
Created attachment 616778 [details] fixed devmanual (textview)
We might indeed report this to upstream. However, so far we might fix this as suggested in https://github.com/gentoo/devmanual/pull/162 by changing the list into a regular ul as suggested by ulm and add individual parents around each link. This way we would get the same behaviour and appearance as before while fixing the issue. I've attached some screenshots.
Why don't we get rid of that list-group altogether? It is used nowhere else in the devmanual, and its items need about twice as much vertical space than the items in a regular <ul> list. Which means that one must scroll by twice as much, in order to reach an item at the bottom of the list.
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=322da3e34dc68d83b8d5cfd4431c8d9ebb092add commit 322da3e34dc68d83b8d5cfd4431c8d9ebb092add Author: Max Magorsch <arzano@gentoo.org> AuthorDate: 2020-03-02 15:43:22 +0000 Commit: Ulrich Müller <ulm@gentoo.org> CommitDate: 2020-03-03 08:27:47 +0000 Fix list-groups in text browsers Closes: https://bugs.gentoo.org/711286 Signed-off-by: Max Magorsch <arzano@gentoo.org> [Removed extra newline before </li>.] Signed-off-by: Ulrich Müller <ulm@gentoo.org> devbook.xsl | 13 +++++++------ devmanual.css | 13 +++++++++++++ 2 files changed, 20 insertions(+), 6 deletions(-)
