search

netmod-wg / yang-ver-dt

Repo for use by the YANG versioning design team
3 stars 3 forks source link

Should the YANG module revision handling retain the version label examples from YANG Semver? #214

Closed rgwilton closed 8 months ago

rgwilton commented 11 months ago

Should the YANG module revision handling document retain the version labels from YANG Semver from the examples? I.e., I was thinking perhaps an informative references. The answer to this is perhaps somewhat related to #212 and #213.

Reshad-Rahman commented 9 months ago

If we remove these examples, I think it's hard to understand the solution just by reading module-versioning. I understand it's hard to avoid reading yang-semver, but those examples are helpful especially to those who haven't followed the work. Asking a reviewer to xref yang-semver to really understand module-versioning is not ideal IMO.

rgwilton commented 9 months ago

Agreement to try removing labels from code but keep in diagram - check if prose is still consistent/underastandable.