Bug 265366

Summary:	FreeBSD Handbook: advanced networking is not the place for wireless basics
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Sergio Carlavilla Delgado <carlavilla>
Status:	Closed Overcome By Events
Severity:	Affects Some People	CC:	carlavilla, doc, emaste, fernape, pauamma
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/tree/main/documentation/content/en/books/handbook
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263315 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=265365 https://reviews.freebsd.org/D40546
Bug Depends on:
Bug Blocks:	263315

Description Graham Perrin freebsd_committer

2022-07-21 20:52:16 UTC

<https://docs.freebsd.org/en/books/handbook/book/#_wireless_networking_basics> (basics) and the nearby quick start, and so on. 

Basics are not _advanced_.

Comment 1 Graham Perrin freebsd_committer

2022-07-23 10:20:02 UTC

The temptation is for <https://docs.freebsd.org/en/books/handbook/advanced-networking/> 

> Advanced networking

– to become simply: 

> Networking

It's not quite so simple, because (at least) the first paragraph under <https://docs.freebsd.org/en/books/handbook/advanced-networking/#advanced-networking-synopsis> is: 

> This chapter covers a number of advanced networking topics.

Then, supposedly: 

> … Before reading this chapter, you should: … Know how to 
> configure and install a new FreeBSD kernel …

For the quick start at <https://docs.freebsd.org/en/books/handbook/advanced-networking/#network-wireless-quick-start> – a "very common situation" – it's quite unnecessary to have that depth of knowledge about the kernel.

Comment 2 Fernando Apesteguía freebsd_committer

2022-10-09 16:02:48 UTC

^Triage: reporter is committer, assign accordingly.

Comment 3 Graham Perrin freebsd_committer

2022-12-30 11:59:34 UTC

Triage, batch edit (just one): 

* for twenty-eight FreeBSD Handbook-related reports that had gained a 
  personal assignee, prior group/list assignee doc@ was 
  missing from the CC list.

Gentle hint: <https://wiki.freebsd.org/Bugzilla/> ▶ do, don't …

Comment 4 Graham Perrin freebsd_committer

2023-07-06 18:37:42 UTC

(In reply to Graham Perrin from comment #1)

New: <https://docs.freebsd.org/en/books/handbook/network/>

> Network

Advanced Networking remains.

Comment 5 Sergio Carlavilla Delgado freebsd_committer

2023-07-13 08:04:26 UTC

Fixed in the new network chapter.
We're gonna keep the "advanced" authentication in the advanced networking chapter.