Bug 264295

Summary: Books: filter field: filter (not Search) for the hint; and the word 'Book' is superfluous
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Books & ArticlesAssignee: Sergio Carlavilla Delgado <carlavilla>
Status: Closed Works As Intended    
Severity: Affects Some People CC: carlavilla, fernape, pauamma
Priority: --- Keywords: needs-patch
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
Screenshot from Discord
none
Screenshot: non-filtered and filtered views of part of the split version of the FreeBSD Handbook none

Description Graham Perrin freebsd_committer freebsd_triage 2022-05-27 17:36:22 UTC 
Created attachment 234272 [details]
Screenshot from Discord

<https://discord.com/channels/727023752348434432/760416197803245591/968297526845378600> (2022-04-26) discussed with carlavilla@

> – instead of Search, filter
> 
> Also the word Book is superfluous. 

<https://forums.freebsd.org/threads/85321/> today observed that the "search function does not work".
Comment 1 Pau Amma 2022-05-28 00:59:06 UTC 
Text equivalent of the image (just the search pane), obtained by copying and pasting ("Search" being the default content of the search box), for screenreader users:

Book chapters
Search
Preface
Part I. Getting Started
Chapter 1. Introduction
Chapter 2. Installing FreeBSD
Chapter 3. FreeBSD Basics
Chapter 4. Installing Applications: Packages and Ports
Chapter 5. The X Window System
Part II. Common Tasks
Chapter 6. Desktop Applications
Chapter 7. Multimedia
Chapter 8. Configuring the FreeBSD Kernel
Chapter 9. Printing
Comment 2 Pau Amma 2022-05-28 01:00:39 UTC 
(My take on this is that it should be changed to a real search in book content, instead of keeping it a filter and changing the name to match.)
Comment 3 Graham Perrin freebsd_committer freebsd_triage 2022-05-28 14:04:36 UTC 
Created attachment 234295 [details]
Screenshot: non-filtered and filtered views of part of the split version of the FreeBSD Handbook

(In reply to PauAmma from comment #2)

I'd prefer to not lose the ability to filter. 

Filtering can, amongst other things, significantly reduce the perception of clutter. 

In the attached screenshot, the lower window (filtered for the glossary) appears cleaner.
Comment 4 Pau Amma 2022-05-29 19:24:32 UTC 
(In reply to Graham Perrin from comment #3)
Hmpf. Point. Maybe combine them? I'm not sure there's enough screen space for separate UI elements, especially for phone browsers.
Comment 5 Fernando Apesteguía freebsd_committer freebsd_triage 2022-10-09 16:08:59 UTC 
^Triage: reporter is committer, assign accordingly.
Comment 6 Graham Perrin freebsd_committer freebsd_triage 2022-10-09 18:22:36 UTC 
(In reply to Fernando Apesteguía from comment #5)

I don't know how to code for bugs such as this, sorry. 

carlavilla@ maybe? TIA
Comment 7 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-07-17 16:23:35 UTC 
The idea of this search input is to search the chapter titles, not in the content.

To find in the content of the documents we can use the top bar search input.

I'm working with bapt@ to create a local search engine to the top bar.

I'm gonna close this PR, thanks for the report.