Details
- Reviewers
salvadore obiwac pauamma_gundo.com - Group Reviewers
status - Commits
- R9:992a0139d1b2: Status/2025Q3/wutil.adoc: Add report
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
Thanks you very much for your report.
In addition to the various inline comments I made, we require reports to put one sentence per line. I can do it and also make the other fixes at merge time if you prefer.
| website/content/en/status/report-2025-07-2025-09/wutil.adoc | ||
|---|---|---|
| 2 | I suggest making the title clearer. If I understand correctly, wutil is a brand new software, so nobody still knows it. Let us describe it shortly right in the title | |
| 5–8 | We usually put the two versions of the same link on the same line | |
| 12 | We have special macros for citing packages and manual pages. Citing manual pages the first time the software is cited is enough | |
| 15 | ||
| 18–23 | We usually avoid the use of contractions | |
| 25–30 | I believe it is better to avoid 0v0 and ^_^: we want our reports to be a bit more formal (not too much, we still allow a friendly language) and, most importantly, we risk to have problems with the various formats our reports might be published in (consider future and yet unknown formts too: we might want to change). | |
I updated it with the commented fixes and to have one sentence per line. Thanks for the reviews :)