<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 14 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.hoenzb
{mso-style-name:hoenzb;}
span.EmailStyle18
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";
mso-fareast-language:EN-US;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-CA link=blue vlink=purple><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>Same here.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><div style='border:none;border-left:solid blue 1.5pt;padding:0cm 0cm 0cm 4.0pt'><div><div style='border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0cm 0cm 0cm'><p class=MsoNormal><b><span lang=EN-US style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>From:</span></b><span lang=EN-US style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> oab@opendnssec.org [mailto:oab@opendnssec.org] <b>On Behalf Of </b>Ondrej Surý<br><b>Sent:</b> March-14-13 5:37 AM<br><b>To:</b> Roland van Rijswijk - Deij<br><b>Cc:</b> Sara Dickinson; oab@opendnssec.org; opendnssec-develop@lists.opendnssec.org Dev<br><b>Subject:</b> Re: Versioning scheme<o:p></o:p></span></p></div></div><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal>Yep, I agree. This is fine with me.<o:p></o:p></p><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>O.<o:p></o:p></p></div></div><div><p class=MsoNormal style='margin-bottom:12.0pt'><o:p> </o:p></p><div><p class=MsoNormal>On Thu, Mar 14, 2013 at 8:29 AM, Roland van Rijswijk - Deij <<a href="mailto:Roland.vanRijswijk@surfnet.nl" target="_blank">Roland.vanRijswijk@surfnet.nl</a>> wrote:<o:p></o:p></p><p class=MsoNormal>Hi Sara,<br><br>Apparently, no one has responded to this one yet, so: bump.<br><br>My 2 cents: I have no problem with the proposed scheme.<br><br>Cheers,<br><br>Roland<o:p></o:p></p><div><div><p class=MsoNormal style='margin-bottom:12.0pt'><br>Sara Dickinson wrote:<br>> Hi All,<br>><br>> The development team had a discussion last year about the versioning scheme used for OpenDNSSEC and the general feeling was that it would make sense to switch from the current component based scheme to an API compatibility based approach. The upcoming release of 1.4 would be a suitable time to change the versioning scheme so I wanted to run this past the board to see if anyone has strong feelings either way before we go ahead with this. The details of the current and proposed scheme are below.<br>><br>> We would obviously need to communicate this change to the users effectively. One impact of the change would probably be to increase the frequency at which the minor versions increased. We might also have to review how the roadmap refers to future releases since version numbers would not be guaranteed (e.g. we could use names not numbers to label releases with specific content) and review what maintenance we provide on older releases too.<br>><br>> Regards<br>><br>> Sara.<br>><br>><br>> Current scheme<br>> ----------------------------<br>><br>> The current version numbering system based on the following (and also direction from the board about what functionality they would like to see in what release):<br>><br>> Releases are numbered using the following scheme: <name>-<major>.<minor>.<patch><br>><br>> • <name> - The name of the software, e.g. opendnssec or softhsm.<br>> • <major> - Indicate changes in the overall system design.<br>> • <minor> - Indicate changes in the components.<br>> • <patch> - Indicate bug fixes.<br>><br>> In practice 'patch' releases often include updates that extend (and sometimes change) functionality, command utilities and/or log output.<br>><br>><br>> Proposed scheme<br>> -----------------------------<br>><br>> Something along the lines of e.g. <a href="http://semver.org/" target="_blank">http://semver.org/</a> which summarises to:<br>><br>> • <name> - The name of the software, e.g. opendnssec or softhsm.<br>> • <major> - Backwards incompatible changes must increase the major version.<br>> • <minor> - New, backwards compatible functionality, deprecated functionality, or substantial new functionality within private code.<br>> • <patch> - Only backwards compatible bug fixes.<br>><br>> This does assume a clearly defined API, so there is an argument for postponing any change until there is a unified control interface for ODS but for 1.4 this could be based on the command utilities and database schema. Note that it also doesn't explicitly exclude bumping the major version for major functional changes in private code.<br>><br>><br>><br>><br>><br>><o:p></o:p></p></div></div><p class=MsoNormal><span class=hoenzb><span style='color:#888888'>--</span></span><span style='color:#888888'><br><span class=hoenzb>-- Roland M. van Rijswijk - Deij</span><br><span class=hoenzb>-- SURFnet bv</span><br><span class=hoenzb>-- w: <a href="http://www.surfnet.nl/en/" target="_blank">http://www.surfnet.nl/en/</a></span><br><span class=hoenzb>-- t: <a href="tel:%2B31-30-2305388">+31-30-2305388</a></span><br><span class=hoenzb>-- e: <a href="mailto:roland.vanrijswijk@surfnet.nl">roland.vanrijswijk@surfnet.nl</a></span></span><o:p></o:p></p></div><p class=MsoNormal><br><br clear=all><o:p></o:p></p><div><p class=MsoNormal><o:p> </o:p></p></div><p class=MsoNormal>-- <br>Ondřej Surý <<a href="mailto:ondrej@sury.org" target="_blank">ondrej@sury.org</a>> <o:p></o:p></p></div></div></div></body></html>