Details
- Reviewers
debdrup - Group Reviewers
docs - Commits
- R9:b3d537c9d52c: handbook: Update the list of websites/community services
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
No Lint Coverage - Unit
No Test Coverage - Build Status
Buildable 44191 Build 41079: arc lint + arc unit
Event Timeline
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. |
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"? |