[Bug 274345] FreeBSD Handbook: correct and improve the Bibliography

From: <bugzilla-noreply_at_freebsd.org>
Date: Sat, 07 Oct 2023 23:38:57 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=274345

            Bug ID: 274345
           Summary: FreeBSD Handbook: correct and improve the Bibliography
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://github.com/freebsd/freebsd-doc/blob/main/docum
                    entation/content/en/books/handbook/bibliography/_index
                    .adoc#bibliography
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com

<https://docs.freebsd.org/en/books/handbook/book/#bibliography>

Rationalise the content of this bibliography with content elsewhere, including
at least: 

1) <https://papers.freebsd.org/> – the collected works of the FreeBSD 
   community as presented at various conferences and summits

2) <https://github.com/DiscoverBSD/awesome-bsd> – A collection of awesome 
   BSD related stuff 

3)
<https://people.freebsd.org/~grahamperrin/273360/273360-hacked-for-images.pdf>
   (books on pages 1–10, magazines 19–20)

4) The UNIX system family tree: Research and BSD.

Re: (4), from a first look at
<https://github.com/freebsd/freebsd-src/blob/9e589b0938579f3f4d89fa5c051f845bf754184d/share/misc/bsd-family-tree#L879-L887>: 

* the first of the two UNIX® books is missing from the UNIX history part of the 
  Bibliography in the FreeBSD Handbook

– and so on. 


Use normal paragraphs, not bullet points. 

Markup/style is inconsistent. 

Entries are disorderly. 

<https://en.wikipedia.org/wiki/ISO_690#Bibliography> under 'External links',
the first two excerpts can be useful.

-- 
You are receiving this mail because:
You are the assignee for the bug.