Bug 274345 - FreeBSD Handbook: correct and improve the Bibliography
Summary: FreeBSD Handbook: correct and improve the Bibliography
Status: Closed Not Accepted
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL: https://github.com/freebsd/freebsd-do...
Keywords:
Depends on:
Blocks:
 
Reported: 2023-10-07 23:38 UTC by Graham Perrin
Modified: 2023-10-08 00:27 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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 freebsd_triage 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 freebsd_triage 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).