The comma on line 93 is not required.
Otherwise reads well.

In D41624#948629, @carlavilla wrote:

Same, thanks!

In D41625#948632, @carlavilla wrote:

Ok but use the one sentence per line please, no need to update the review, can be changed in the commit.
Apart from that ok from docs side :)

In D40026#911559, @bofh wrote:

! In D40026#911558, @ceri wrote:
Can we discuss these vale rules on the list please?
I’m not sure that some of them lead to clearer documentation in the way that is hoped (sometimes because it is clear that authors do not know how to write sentences that comply with them, so we end up with badly written English that passes tests).

Feel free to fireup a discussion on the ML. Currently we do not have any grammatical rules except weasel words which I am planning to remove as it will be a too big of a task. All the rules are much more syntaxtical. Currently I believe there are hardly 3/4 doc comitters who are actually using this. :'(

In D40026#911545, @bofh wrote:

Don't use "you", I know is used across the documentation, but the idea is to remove the use of it

@carlavilla The idea of removing doesn't look too promising. :/

❯ find . -type f -name "*.adoc" -exec grep -i -E '\syou\s' {} \+ | wc -l
   15453

Do you want me to writ a vale rule? 3:)

UPDATING and src.conf.5 updates too?

New diff addressing points raised

A note that mail to dteske is timing out and bouncing, so am inclined to commit this.

Is it possible to have a minimal port that solves this problem please?

In D37503#852734, @carlavilla wrote:

Looks good to me.
Only to improve my English. Why "FreeBSD's Handbook" is not ok?
I always thought that you use this to express that the Handbook is "property?" of FreeBSD.

Reword. This would have benefitted from much wider review, from inception to commit. Please allow more time for these wide-ranging changes, and perhaps invite feedback on the doc@ mailing list.

I think doceng need to decide if this is a valid engineering goal, based on recent discussions.

Running out of battery so submitting what I have reviewed. Generally speaking I think the shorter text works against the intent of this being a guide, I'm afraid.

Clarify situation muddied by mention of the port.

Lgtm, thanks.

Thanks!