Date: Tue, 11 Jan 2022 12:46:31 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=261104 Bug ID: 261104 Summary: new handbook website format, multiple problems Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Website Assignee: doc@FreeBSD.org Reporter: email@example.com Viewing http://freebsd.org/handbook with Firefox 93.0 uname: FreeBSD 12.2-STABLE r370671 GENERIC amd64 package: firefox-93.0_1,2 Multiple problems with new handbook layout a) styles such as "fa-pencil-square-o" uses non-existent UTF-8 character F044 which renders as a box with hex values rather than an actual font. Also F015 and F105 used by fa-angle-right and fa-home are similar. If these UTF-8 characters are to be used in the content, an appropriate web font will also need to be selected and loaded in the HEAD section. b) use of script is most likely a bad idea. However, without script enabled, the pages still "functions" but is actually easier to read since the fonts are not gray. However, the logo banner is missing. c) FreeBSD logo is 2-color which is inconsistent with the main page. It should at least match the main page for consistent appearance. The flat-look is also inferior to a proper 3d skeuomorphic icon like is seen on the main freebsd.org page. d) font size in left panel is too small to read, and inconsistent with the main text. When zooming out to 150%, the left panel becomes readable, but the text is too large (and requires more screen scrolling) e) the scrollbar in the left panel is inconsistent with the system theme. Where it always seems to have an (inferior) 'Adwaita' appearance, it is also too thin to use properly. It should have a scrollbar that matches the system theme. This might be doable using a scrollable table with 'overflow:auto' and 'display:inline-block' styles and fixed height that would then apply the correct system appearance and width to the scroll bar. f) the left panel cannot be re-sized. As a result, you get inconsistent appearance when script is enabled, and the text tends to wrap. g) the "light" theme uses grey fonts that make them harder to read. it should use a black font or have an alternative that uses a black font instead of grey. The dark and high contrast themes both have dark background, meaning that if you want a consistent light background you are stuck with a hard to read font. h) an option to use the old format should be available (I prefer it, easier to use for me). To get the same effect I did attempt to use 'reader' mode in Firefox, which appears to be supported by the handbook pages; however, the overall appearance wasted a lot of screen real estate (see attachment) (attaching screen shots, one with script, one without, one in reader mode) -- You are receiving this mail because: You are the assignee for the bug.