Miscellaneous small changes to the Committer's Guide.

[pauamma_gundo.com]

Summary

PR: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=261812

Plus a few more I spotted while working on it.

Test Plan

make all
Eyeball lynx output.

[pauamma_gundo.com]

Noting that I can't read /home/portmgr/public, so I can't verify the full pathname for those reports is still correct.

[gjb]

Approved.

[grahamperrin]

… gitrepo.freebsd.org has been canonicalized to repo.freebsd.org. …

There remain uses of gitrepo, is this intended?

Sorry for the late feedback.

[pauamma_gundo.com]

In D37091#842793, @grahamperrin wrote:

… gitrepo.freebsd.org has been canonicalized to repo.freebsd.org. …

There remain uses of gitrepo, is this intended?

I didn't intend to change uses of it in the text, if that's what you're asking. Whether they should be changed is more than I can say. All this is saying is what happened in DNS. Should I make that explicit?

[grahamperrin]

In D37091#842794, @pauamma wrote:

… Whether they should be changed is more than I can say.

"… the future is now. …", so if not amongst this round of edits, we can update the text in the next round.

(I don't want to complicate this review for you.)

All this is saying is what happened in DNS. Should I make that explicit?

I think, simply:

• change things to use what's now correct for the primary source of truth i.e. repo.FreeBSD.org
• don't use the Guide to describe the reason for change.

(I still prefer lowercase repo.freebsd.org, but that's a conversation for another day.)

If a committer becomes curious about what happened to gitrepo.freebsd.org, it'll be easy enough for the person to find the explanation.

[pauamma_gundo.com]

NTS: portmgr reports are again readable.

[philip]

Looks good.

documentation/content/en/articles/committers-guide/_index.adoc

92

I think these locations should spell out freefall rather than FreeBSD.org cluster. This information probably dates back to when we had NFS mounts to machine-whose-name-we-do-not-speak all over the cluster.

180

Does a more authoritative source exist than some individual's personal diary?

[pauamma_gundo.com]

documentation/content/en/articles/committers-guide/_index.adoc

180

Probably, but I'm unable to evaluate those claims. Implied question ("which authoritative sources discuss key sizes?") is beyond me. All I can suggest is removing the link if deemed too unreliable.

[pauamma_gundo.com]

• Address philip's comments.
• While there, check nearby URLs still work and use https:.

[pauamma_gundo.com]

*ping mentors* (for the latest version)

[pauamma_gundo.com]

ping carlavilla gjb