Bug 241673

Summary: FreeBSD Handbook: Domain Name System (DNS): add a brief subsection for authoritative nameservers
Product: Documentation Reporter: f.toscan
Component: Books & ArticlesAssignee: Gordon Bergling <gbe>
Status: Closed FIXED    
Severity: Affects Some People CC: doc, freebsd, gbe, pauamma
Priority: --- Flags: grahamperrin: maintainer-feedback? (gbe)
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://docs.freebsd.org/en/books/handbook/network-servers/#network-dns
See Also: https://reviews.freebsd.org/D42632
Bug Depends on:    
Bug Blocks: 263315    
Attachments:
Description Flags
Patch none

Description f.toscan 2019-11-02 14:24:18 UTC
Created attachment 208799 [details]
Patch

Handbook explains what authoritative and caching nameservers are, but subsections cover just resolvers.
Add a section dedicated to authoritative nameservers and explain that users must install the desired software from ports or packages.
Comment 1 Pau Amma 2022-04-11 05:57:12 UTC
Are you still planning to make this change?
Comment 2 Graham Perrin freebsd_committer freebsd_triage 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 3 Leo Vandewoestijne 2023-07-13 08:31:20 UTC
I'm aware this was created in 2019 - while today it's 2023...

dns/bind914 is gone by now - I would suggest dns/bind918 instead.

Also I think dns/knot3 deserves to be mentioned there.
Comment 4 Gordon Bergling freebsd_committer freebsd_triage 2023-11-16 12:50:59 UTC
I created a differential for it.
Comment 5 commit-hook freebsd_committer freebsd_triage 2023-11-17 19:26:01 UTC
A commit in branch main references this bug:

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

commit af80f282ba9b4780f69459b92c6fbe319007834a
Author:     Gordon Bergling <gbe@FreeBSD.org>
AuthorDate: 2023-11-17 19:22:51 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2023-11-17 19:22:51 +0000

    handbook/network-servers: Add a paragraph about authoritative name servers

    Add a paragraph about authoritative name servers and mention two packages
    that can be used.

    PR:     241673
    Reviewed by:    fernape
    Differential Revision:  https://reviews.freebsd.org/D42632

 .../en/books/handbook/network-servers/_index.adoc  |    3 +
 .../network-servers/_index.adoc.orig (new)         | 3016 ++++++++++++++++++++
 2 files changed, 3019 insertions(+)
Comment 6 commit-hook freebsd_committer freebsd_triage 2023-11-17 19:28:04 UTC
A commit in branch main references this bug:

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

commit 2016893e14e43b4f14e1c279f4de7b7c43d27cca
Author:     Gordon Bergling <gbe@FreeBSD.org>
AuthorDate: 2023-11-17 19:27:09 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2023-11-17 19:27:09 +0000

    Remove accidentally commited .orig file

    PR:     241673

 .../network-servers/_index.adoc.orig (gone)        | 3016 --------------------
 1 file changed, 3016 deletions(-)
Comment 7 Gordon Bergling freebsd_committer freebsd_triage 2023-11-17 19:28:45 UTC
Committed in a slightly modified version.

Thanks for the patch.