Bug 260705

Summary:	Accessibility: with the redesign, it's no longer easy to reach the first (front, home) pages of books such as the FreeBSD Handbook
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Sergio Carlavilla Delgado <carlavilla>
Status:	Closed FIXED
Severity:	Affects Many People	CC:	carlavilla
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://web.archive.org/web/20211120113533/https://docs.freebsd.org/en/books/handbook/basics/
Bug Depends on:	259371
Bug Blocks:

Description Graham Perrin freebsd_committer

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

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

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

2021-12-31 12:29:52 UTC

Fixed. Thanks for the report.