<div dir="ltr"><div>Thanks for the additional info Scott.<br></div><div>I hadn't considered that some organizations (you mention ISO) only maintain one baseline version, and deprecate previous versions.</div><div><br></div><div>Looping in: +Ronald Tse <<a href="mailto:tse@ribose.com">tse@ribose.com</a>>, +Reese W. Plews <<a href="mailto:rplews@gmail.com">rplews@gmail.com</a>> and our public  glossary email list <a class="gmail_plusreply" id="gmail-plusReplyChip-5" href="mailto:lexicon@lists.osgeo.org" tabindex="-1">+lexicon</a> which contains all the looped in participants.</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jan 4, 2022 at 5:51 AM Scott Simmons <<a href="mailto:ssimmons@ogc.org">ssimmons@ogc.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div style="overflow-wrap: break-word;">Hi Cameron,<div><br></div><div>I would like to see more standards for document content and versioning as everything is pretty loose and I feel that many organizations have to make up their own rules (or copy rules from others). I think that we have two end-member states: (1) versioned documents such as OGC, OMG, IHO, etc. Standards and (2) non-versioned documents such as ISO Standards.</div><div><br></div><div>The versioned community generally has some concept of significance of the version and accommodation of backward compatibility. OGC and IHO are very strict in the rules and conventions. Multiple versions may be supported at one time (especially with OGC).</div><div><br></div><div>The non-versioned community treats each new edition as independent of the old and usually deprecates the older version. ISO makes no promises of backward compatibility and I do not think that there is a rule that requires that differences between publications be documented.</div><div><br></div><div>So, yes, OGC would be happy to submit our rules to be part of a larger document versioning Standard. We’d even be happy to reference such a Standard as normative if it mostly agrees with our current rule set.</div><div><br></div><div>I think that we should loop Ron Tse into this conversation as his work on content management and model-driven Standards would allow for more quantitative measure of the degree in change between versions.</div><div><br></div><div>Best Regards,</div><div>Scott<br><div><br><blockquote type="cite"><div>On Dec 31, 2021, at 12:21 PM, Cameron Shorter <<a href="mailto:shortcam@google.com" target="_blank">shortcam@google.com</a>> wrote:</div><br><div><div dir="ltr">Thanks for the feedback Scott,<div>I've added a link to your directive 18 from the Further Reading section.</div><div>Would there be value in moving OGC's directive 18 toward a community wide Semantic Versioning for Docs standard. How would this be approached? Is there a lightweight review process that OGC members could be invited to take part in?</div><div><br></div><div>Do you know of a person or group within ISO and/or IEEE who would be worth reaching out to with a similar message?</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Dec 31, 2021 at 8:47 AM Scott Simmons <<a href="mailto:ssimmons@ogc.org" target="_blank">ssimmons@ogc.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div>Hi Cameron,<div><br></div><div>I am not aware of document-specific versioning conventions and we generally use SemVer in OGC. The only OGC documents that are versioned are Standards or Best Practices and since those are really just written specifications, SemVer is appropriate. Our own versioning policy is Policy Directive 18 here: <a href="https://portal.ogc.org/public_ogc/directives/directives.php" target="_blank">https://portal.ogc.org/public_ogc/directives/directives.php</a></div><div><br></div><div>I think that your document-centric version makes a lot of sense. Given that even technical documentation does not always have the consideration of “backward compatibility,” I wonder if there is another term that may be more appropriate. Is a minor version only appropriate when documenting something which itself has minor versioning?</div><div><br></div><div>Best Regards,</div><div>Scott <br><div><br><blockquote type="cite"><div>On Dec 22, 2021, at 1:48 PM, Cameron Shorter <<a href="mailto:shortcam@google.com" target="_blank">shortcam@google.com</a>> wrote:</div><br><div><div dir="ltr">Hi Scott,<div>Are you aware of published semantic versioning standards or conventions which are applied to documentation? (Specifications are one variant of such standards.)</div><div><br></div><div>I have a need for documentation semantic versioning for two projects I'm involved in:</div><div>1. For specifications I'm drafting at Google.</div><div>2. For documentation templates we are developing within <a href="https://thegooddocsproject.dev/" target="_blank">The Good Docs Project</a>. (Doc templates for open source.)</div><div><br></div><div>We've drafted a possible <a href="https://docs.google.com/document/d/1gPr_OHoUkg5Wjj3UWYX78ORtTBArSJck4mWrKhWpfPA" target="_blank">semantic versioning addendum for documents</a>, and are looking for:</div><div>* Pointers to any related initiatives which we could defer to if they exist.</div><div>* Introductions to people who might be interested in filling this space. (Feel free to forward this email.)</div><div>* Feedback on our proposal. (Feel free to add comments.)</div><div><div><br></div><div>Cheers,<br clear="all"><div><br></div>-- <br><div dir="ltr"><div dir="ltr">Cameron Shorter,<div>Technical Writer, ChromeOS Platforms</div></div></div></div></div></div>
</div></blockquote></div><br></div></div>
<br>
<img src="https://portal.ogc.org/files/?artifact_id=99287"><br><div><a href="https://ogc.us4.list-manage.com/subscribe?u=704e02f81107a6caab1568067&id=4e4528fd9d" target="_blank"><span style="font-weight:700;white-space:pre-wrap">Sign up for OGC News</span></a><br></div></blockquote></div>
</div></blockquote></div><br></div></div>
<br>
<img src="https://portal.ogc.org/files/?artifact_id=99287"><br><div><a href="https://ogc.us4.list-manage.com/subscribe?u=704e02f81107a6caab1568067&id=4e4528fd9d" target="_blank"><span style="font-weight:700;white-space:pre-wrap">Sign up for OGC News</span></a><br></div></blockquote></div>