Details
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
Lint Skipped - Unit
Tests Skipped
Event Timeline
My usual mistake: whitespace errors. Corrected prior to a9f81805c39b8a6e0ec6e87ce6d7151764ea850c at:
Pull request closed by my deletion of the patch-2 branch:
End result (currently chapter 4, section 4.4):
| documentation/content/en/books/fdp-primer/structure/_index.adoc | ||
|---|---|---|
| 155–157 | Some wrongness, maybe due to me working with split (not my usual preference) during part of this review. When a book is viewed as a book, in its entirety:
{F52387089} | |
AsciiDoc Language Documentation at Asciidoctor Docs – https://docs.asciidoctor.org/asciidoc/latest/ – is definitive, and clear.
Gut feeling: if it's not easy to paraphrase, accurately, what's definitive, then we should remove what's wrong from this book and allow readers to learn from the definitive point of reference.
| documentation/content/en/books/fdp-primer/structure/_index.adoc | ||
|---|---|---|
| 151 | The implication: all books have multiple parts. Maybe truer to say that a book can have more than one part.
If I understand correctly, FreeBSD Documentation Project Primer for New Contributors is:
– it has only one part, with AsciiDoc section level 0 used for its first chapter. https://cgit.freebsd.org/doc/tree/documentation/content/en/books/fdp-primer/overview/_index.adoc#n13: = Overview – and so on. | |