Rephrase and polish to make it more understandable

This addresses the feedback from the review. It also rephrases the
versioning requirements in terms of a current version instead of
the confusing primary and secondary versions.

The patch will be squashed before merging.