Summary: | FAQ: links to the handbook are broken | ||
---|---|---|---|
Product: | Documentation | Reporter: | Mitchell Horne <mhorne> |
Component: | Books & Articles | Assignee: | Sergio Carlavilla Delgado <carlavilla> |
Status: | Closed FIXED | ||
Severity: | Affects Only Me | CC: | carlavilla, grahamperrin |
Priority: | --- | ||
Version: | Latest | ||
Hardware: | Any | ||
OS: | Any |
Description
Mitchell Horne
2021-10-21 14:11:32 UTC
It's fixed in this review: https://reviews.freebsd.org/D31926 > How can I correct the keyboard mappings for my system? The single-sentence paragraph under <https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/faq/_index.adoc#107-how-can-i-correct-the-keyboard-mappings-for-my-system> | <https://docs.freebsd.org/en/books/faq/#keyboard-mappings>: > Refer to the Handbook section on using localization, specifically the > section on console setup. – both links are broken: <https://docs.freebsd.org/en/books/handbook/#using-localization> <https://docs.freebsd.org/en/books/handbook/#setting-console> Instead: <https://docs.freebsd.org/en/books/handbook/l10n/> <https://docs.freebsd.org/en/books/handbook/book/#l10n> <https://docs.freebsd.org/en/books/handbook/l10n/#setting-console> <https://docs.freebsd.org/en/books/handbook/book/#setting-console> – where 'Localization - i18n/L10n Usage and Setup' is the title of the _chapter_ (not a section within a chapter). Consider rewording the paragraph: > See the Console Setup section of Localization - i18n/L10n Usage and Setup, > kbdmap(1) in particular. (The Handbook is misleading, I'll raise a separate bug for this.) ---- See also: bug 260199, bug 263320 (likely overlap with FAQ). (In reply to Sergio Carlavilla Delgado from comment #1) Hi Sergio, The linked review was marked as Closed, but I cannot tell if the change was committed. Can you comment on the status here? As of today the mentioned links in the FAQ are still broken. (In reply to Mitchell Horne from comment #3) I'm gonna take a look. A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/doc/commit/?id=d46632e1af2002089721a751d7655401f513fe43 commit d46632e1af2002089721a751d7655401f513fe43 Author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> AuthorDate: 2022-09-04 10:29:12 +0000 Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> CommitDate: 2022-09-04 10:30:29 +0000 Fix links to the handbook in FAQ PR: 259342, 266107 Submitted by: grahamperrin@, mhorne@ documentation/content/en/books/faq/_index.adoc | 76 +++++++++++++------------- 1 file changed, 38 insertions(+), 38 deletions(-) Fixed. I reviewed all the links. There are three which I cannot link correctly to the handbook since the anchor was removed in the handbook. Btw, I'm gonna start a rewrite of the FAQ in the EuroBSDCon |