Bug 274345

Summary:	FreeBSD Handbook: correct and improve the Bibliography
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Sergio Carlavilla Delgado <carlavilla>
Status:	Closed Not Accepted
Severity:	Affects Some People	CC:	carlavilla, doc
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/bibliography/_index.adoc#bibliography

Description Graham Perrin 2023-10-07 23:38:57 UTC

<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.

Comment 1 Sergio Carlavilla Delgado freebsd_committer

2023-10-07 23:43:32 UTC

This section has been reviewed as part of the handbook working group.
I close it as not accepted.

Comment 2 Graham Perrin 2023-10-07 23:50:24 UTC

If not in the FreeBSD Handbook, I can at least aim to make things orderly and suitably elsewhere.

Comment 3 Sergio Carlavilla Delgado freebsd_committer

2023-10-07 23:51:23 UTC

(In reply to Graham Perrin from comment #2)
No

Comment 4 Graham Perrin 2023-10-08 00:27:40 UTC

(In reply to Graham Perrin from comment #2)

> suitably elsewhere.

Sorry, I missed a word. Suitably styled elsewhere. 

Also, sorry that I didn't see proposed changes before they were made. Unless I'm missing something, no review in Phabricator; no signal to the docs group (people who are willing to review documentation changes).