Page MenuHomeFreeBSD

handbook: Update the list of websites/community services
ClosedPublic

Authored by trasz on Jan 29 2022, 2:30 PM.
Tags
None
Referenced Files
Unknown Object (File)
Thu, Apr 4, 7:07 PM
Unknown Object (File)
Jan 12 2024, 2:37 PM
Unknown Object (File)
Jan 11 2024, 11:21 PM
Unknown Object (File)
Jan 11 2024, 2:23 PM
Unknown Object (File)
Dec 25 2023, 6:02 PM
Unknown Object (File)
Dec 25 2023, 6:02 PM
Unknown Object (File)
Dec 25 2023, 6:02 PM
Unknown Object (File)
Dec 25 2023, 6:02 PM

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

trasz requested review of this revision.Jan 29 2022, 2:30 PM
trasz created this revision.

Here's a few things I noticed.

documentation/content/en/books/handbook/eresources/_index.adoc
63–65

Why is the 'The' article part of the link here, but not on the line below?

64

I'd like it if it's just referred to the FreeBSD Status Reports

65

I think this sentence needs to be reworked so it doesn't start with site-specific URI terminology, and also starts with a capitalized-first-letter word.

69

This sentence also needs to be reworked so it starts with a capitalized-first-letter word.

All external links need link: prefixed per https://docs.freebsd.org/en/books/fdp-primer/asciidoctor-primer/#asciidoctor-links . (Mentioning it only once instead of leaving a bunch of line edits.)

documentation/content/en/books/handbook/eresources/_index.adoc
57
63
64

IIRC, none of the books is called a manual. They all have "handbook" in their titles. Maybe stick with that, if that wouldn't make "the Handbook" (which is really the User's Handbook, not whichever FreeBSD handbook was last mentioned) confusing.

64

That also needs either s/progress/progress of/ or s/progress //.

65
65

Does my suggestion work for you?

68

Maybe "interactive" instead of "realtime"? 4 hours between question and answer is common, and first-time users unfamiliar with the culture do get discouraged and leave too soon, so setting reasonable expectations may lead to a better introduction to IRC FreeBSD support.

This revision is now accepted and ready to land.Jan 30 2022, 6:08 PM
documentation/content/en/books/handbook/eresources/_index.adoc
66

Instinct tells me "free" should come earlier in that list of adjectives, but it's been known to be wrong.

675

Nitpick; depending on the bug type, it may go to another list instead unless -bugs@ is always silently bcc'd. So perhaps get rid of the final "to it"?

Two more tweaks from Pau.

This revision now requires review to proceed.Jan 31 2022, 4:07 PM
This revision was not accepted when it landed; it landed in state Needs Review.Feb 1 2022, 9:12 AM
This revision was automatically updated to reflect the committed changes.