Date: Tue, 11 Jan 2022 12:46:31 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 261104] new handbook website format, multiple problems Message-ID: <bug-261104-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D261104 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: bobf@mrp3.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 F0= 44 which renders as a box with hex values rather than an actual font. Also F0= 15 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 enable= d, 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 sh= ould at least match the main page for consistent appearance. The flat-look is a= lso 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 t= ext is too large (and requires more screen scrolling) e) the scrollbar in the left panel is inconsistent with the system theme.=20 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 syst= em 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 sho= uld use a black font or have an alternative that uses a black font instead of g= rey. 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 fo= nt. 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) --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-261104-9>