Bug 260705 - Accessibility: with the redesign, it's no longer easy to reach the first (front, home) pages of books such as the FreeBSD Handbook
Summary: Accessibility: with the redesign, it's no longer easy to reach the first (fro...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Sergio Carlavilla Delgado
URL: https://web.archive.org/web/202111201...
Keywords:
Depends on: 259371
Blocks:
  Show dependency treegraph
 
Reported: 2021-12-26 17:17 UTC by Graham Perrin
Modified: 2021-12-31 12:29 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2021-12-26 17:17:41 UTC
Please compare the feet of pages such as these: 

<https://web.archive.org/web/20211120113533/https://docs.freebsd.org/en/books/handbook/basics/>

<https://docs.freebsd.org/en/books/handbook/basics/#basics-more-information>

Where previously there was a user-friendly 'Home' link, for the first page: 

* there's no longer a single-click approach. 

Workaround: 

1. point at, not necessarily click, the 'Book chapters' column

2. scroll to the head of the column

3. click Preface

4. (does not present the preface; this feels like a separate bug)

5. click 'Intended Audience'

6. point at the main content column

7. scroll to the foot of the column

8. click 'Prev'. 

----

There's a comparable issue with, for example, <https://docs.freebsd.org/en/books/porters-handbook/porting-dads/#dads-misc> – no single click from there, to the front page, so: 

* I assume that this bug is somewhat generic to books.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2021-12-26 17:21:09 UTC
From bug 259371 comment 4: 

> … I suspect that (in addition to the HTML title), the new design will 
> require the title of the document to be visible in the red banner/header 
> at the top of the page.

If the banner/header can be used in this way, then a click on the title should take the reader to the front page.
Comment 2 commit-hook freebsd_committer freebsd_triage 2021-12-31 12:27:19 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=e8a6a98110ea377c2717da8d185f44bc30085a7d

commit e8a6a98110ea377c2717da8d185f44bc30085a7d
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2021-12-31 12:25:39 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2021-12-31 12:25:39 +0000

    Add home button to the navigation of the books

    PR:             260705
    Submitted by:   Graham Perrin <grahamperrin (AT) gmail.com>

 .../beastie/assets/styles/documentation.scss       | 11 +++++--
 documentation/themes/beastie/i18n/bn-bd.toml       |  3 ++
 documentation/themes/beastie/i18n/da.toml          |  3 ++
 documentation/themes/beastie/i18n/de.toml          |  3 ++
 documentation/themes/beastie/i18n/el.toml          |  3 ++
 documentation/themes/beastie/i18n/en.toml          |  3 ++
 documentation/themes/beastie/i18n/es.toml          |  3 ++
 documentation/themes/beastie/i18n/fr.toml          |  3 ++
 documentation/themes/beastie/i18n/hu.toml          |  3 ++
 documentation/themes/beastie/i18n/it.toml          |  3 ++
 documentation/themes/beastie/i18n/ja.toml          |  3 ++
 documentation/themes/beastie/i18n/ko.toml          |  3 ++
 documentation/themes/beastie/i18n/mn.toml          |  3 ++
 documentation/themes/beastie/i18n/nl.toml          |  3 ++
 documentation/themes/beastie/i18n/pl.toml          |  3 ++
 documentation/themes/beastie/i18n/pt-br.toml       |  3 ++
 documentation/themes/beastie/i18n/ru.toml          |  3 ++
 documentation/themes/beastie/i18n/tr.toml          |  3 ++
 documentation/themes/beastie/i18n/zh-cn.toml       |  3 ++
 documentation/themes/beastie/i18n/zh-tw.toml       |  3 ++
 .../themes/beastie/layouts/books/list.html         | 35 ++++++++++++++++++++++
 .../themes/beastie/layouts/books/single.html       | 35 ++++++++++++++++++++++
 22 files changed, 136 insertions(+), 2 deletions(-)
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2021-12-31 12:29:52 UTC
Fixed. Thanks for the report.