[Bug 261104] new handbook website format, multiple problems

From: <bugzilla-noreply_at_freebsd.org>
Date: Tue, 11 Jan 2022 12:46:31 UTC

            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 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

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.