ports.7: Document DEFAULT_VERSIONS

[ziaee]

Summary

MFC after: 3 days
Reported by: adamw

[adamw]

I like this, but version … version reads a little oddly.

What about using “variant” for one of them? (Gotta credit my wife for that idea; I drew a blank lol)

[ziaee]

wordsmith

[adamw]

I spent a looooong time with ChatGPT working on phrasing. Why is this one so tough?!

What I came up with was: "Override the defaults for ports with selectable variants."?

Depending on length target, we could really clear it up for users by adding "such as database and compiler versions."

I dunno, folks. Maybe we should just say "DEFAULT_VERSIONS: Sets default versions" 🙄

[ziaee]

use database or compiler versions, i like that.
i like the text we've come up with so far otherwise.

[adamw]

In D55443#1272019, @ziaee wrote:

use database or compiler versions, i like that.
i like the text we've come up with so far otherwise.

"Variant ... variant" didn't feel good, but with the rest of the sentence, it now reads well. I like this change and I say go for it!

[ziaee]

Oops, the multiple variants was a typo. I actually want to use version
for the second one. Thanks for your attention to detail here!

[adamw]

Oh yeah, this is the one. 100% 👍 from me.