{"id":2312,"date":"2021-05-10T17:11:53","date_gmt":"2021-05-10T15:11:53","guid":{"rendered":"https:\/\/smartdatamodels.org\/?page_id=2312"},"modified":"2021-05-10T17:11:53","modified_gmt":"2021-05-10T15:11:53","slug":"versioning-policy","status":"publish","type":"page","link":"https:\/\/smartdatamodels.org\/index.php\/versioning-policy\/","title":{"rendered":"Versioning policy"},"content":{"rendered":"<p><code><div id=\"file\" class=\"md\" data-path=\"versioning.md\"><article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><div class=\"markdown-heading\" dir=\"auto\"><h2 class=\"heading-element\" dir=\"auto\">NORMAL VERSION<\/h2><a id=\"user-content-normal-version\" class=\"anchor\" aria-label=\"Permalink: NORMAL VERSION\" href=\"#normal-version\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"><\/path><\/svg><\/a><\/div>\n<p dir=\"auto\">A normal version number MUST take the form X.Y.Z where X, Y, and Z are non-negative integers, and MUST NOT contain leading zeroes but for draft versions. X is the major version, Y is the minor version, and Z is the patch version. Each element MUST increase numerically. For instance: 1.9.0 -&gt; 1.10.0 -&gt; 1.11.0.<\/p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"Once a versioned data model has been released, the contents of that version MUST NOT be modified. Any modifications MUST be released as a new version.\n\nMajor version zero (0.y.z) is for initial data model draft.\n\nVersion 1.0.0 defines the first public data model version. The way in which the version number is incremented after this release is dependent on this document.\"><pre class=\"notranslate\"><code>Once a versioned data model has been released, the contents of that version MUST NOT be modified. Any modifications MUST be released as a new version.\n\nMajor version zero (0.y.z) is for initial data model draft.\n\nVersion 1.0.0 defines the first public data model version. The way in which the version number is incremented after this release is dependent on this document.\n<\/code><\/pre><\/div>\n<div class=\"markdown-heading\" dir=\"auto\"><h2 class=\"heading-element\" dir=\"auto\">PATCH VERSION<\/h2><a id=\"user-content-patch-version\" class=\"anchor\" aria-label=\"Permalink: PATCH VERSION\" href=\"#patch-version\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"><\/path><\/svg><\/a><\/div>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"Patch version Z (x.y.Z | x &gt; 0) MUST be incremented if only backwards compatible fixes are introduced. A fix is defined as an internal change that fixes incorrect behavior.\nPatch version can be approved by any Subject administrator\"><pre class=\"notranslate\"><code>Patch version Z (x.y.Z | x &gt; 0) MUST be incremented if only backwards compatible fixes are introduced. A fix is defined as an internal change that fixes incorrect behavior.\nPatch version can be approved by any Subject administrator\n<\/code><\/pre><\/div>\n<div class=\"markdown-heading\" dir=\"auto\"><h2 class=\"heading-element\" dir=\"auto\">MINOR VERSION<\/h2><a id=\"user-content-minor-version\" class=\"anchor\" aria-label=\"Permalink: MINOR VERSION\" href=\"#minor-version\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"><\/path><\/svg><\/a><\/div>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"Minor version Y (x.Y.z | x &gt; 0) MUST be incremented if new, backwards compatible functionality is introduced to the data model (i.e. a new non required property is added). It MUST be incremented if any property is added. It MAY include patch level changes. Patch version MUST be reset to 0 when minor version is incremented.\nIf data model does NOT belong to the Cross sector domain, patch version can be approved by any Subject administrator but notified to domain administrator. If the data model belongs to the Cross Sector domain if can be approved by Subjwect administrator but notified to all afffected domain administrators.\"><pre class=\"notranslate\"><code>Minor version Y (x.Y.z | x &gt; 0) MUST be incremented if new, backwards compatible functionality is introduced to the data model (i.e. a new non required property is added). It MUST be incremented if any property is added. It MAY include patch level changes. Patch version MUST be reset to 0 when minor version is incremented.\nIf data model does NOT belong to the Cross sector domain, patch version can be approved by any Subject administrator but notified to domain administrator. If the data model belongs to the Cross Sector domain if can be approved by Subjwect administrator but notified to all afffected domain administrators.\n<\/code><\/pre><\/div>\n<div class=\"markdown-heading\" dir=\"auto\"><h2 class=\"heading-element\" dir=\"auto\">MAJOR VERSION<\/h2><a id=\"user-content-major-version\" class=\"anchor\" aria-label=\"Permalink: MAJOR VERSION\" href=\"#major-version\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"><\/path><\/svg><\/a><\/div>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"Major version X (X.y.z | X &gt; 0) MUST be incremented if any backwards incompatible changes are introduced to the data model. It MAY also include minor and patch level changes. Patch and minor version MUST be reset to 0 when major version is incremented.\nThis versions has to be approved by the management because it could impact \"><pre class=\"notranslate\"><code>Major version X (X.y.z | X &gt; 0) MUST be incremented if any backwards incompatible changes are introduced to the data model. It MAY also include minor and patch level changes. Patch and minor version MUST be reset to 0 when major version is incremented.\nThis versions has to be approved by the management because it could impact \n<\/code><\/pre><\/div>\n<\/article><\/div><\/code><\/p>\n","protected":false},"excerpt":{"rendered":"<p> <a class=\"continue-reading-link\" href=\"https:\/\/smartdatamodels.org\/index.php\/versioning-policy\/\">More&#8230;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"class_list":["post-2312","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":37,"url":"https:\/\/smartdatamodels.org\/index.php\/domain-repositories\/","url_meta":{"origin":2312,"position":0},"title":"Domain repositories","author":"maestro","date":"17\/03\/2020","format":false,"excerpt":"List of main domains repositories https:\/\/github.com\/smart-data-models\/CrossSector https:\/\/github.com\/smart-data-models\/Smart-Sensoring https:\/\/github.com\/smart-data-models\/SmartAgrifood https:\/\/github.com\/smart-data-models\/SmartCities https:\/\/github.com\/smart-data-models\/SmartEnergy https:\/\/github.com\/smart-data-models\/SmartEnvironment https:\/\/github.com\/smart-data-models\/SmartWater \u00a0","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":1217,"url":"https:\/\/smartdatamodels.org\/index.php\/list-of-data-models-2\/","url_meta":{"origin":2312,"position":1},"title":"List of data models","author":"maestro","date":"01\/01\/2021","format":false,"excerpt":"List of data models","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":60,"url":"https:\/\/smartdatamodels.org\/index.php\/list-of-data-models\/","url_meta":{"origin":2312,"position":2},"title":"List of data models and repositories","author":"maestro","date":"17\/03\/2020","format":false,"excerpt":"This page is obsolete, you should use the search tool. Check here any term you want to check if it is already standardized. If not maybe it could suggest it here choose the option new data model. List of data models","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":192,"url":"https:\/\/smartdatamodels.org\/index.php\/use-data-models\/","url_meta":{"origin":2312,"position":3},"title":"use Data models","author":"maestro","date":"20\/03\/2020","format":false,"excerpt":"All the data models available in Github under the umbrella repository smart-data-models are free to use and with an open license allowing its modification. You have a list here. There are examples in all of them in several formats, including json, jsonld, dtdl and csv. Additionally, there are schemas that\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":596,"url":"https:\/\/smartdatamodels.org\/index.php\/smart-data-models-survey\/","url_meta":{"origin":2312,"position":4},"title":"Smart data models Survey","author":"maestro","date":"02\/09\/2020","format":false,"excerpt":"","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":10620,"url":"https:\/\/smartdatamodels.org\/index.php\/smart-cities-domain-at-smart-data-models\/","url_meta":{"origin":2312,"position":5},"title":"Smart Cities domain at Smart Data Models","author":"maestro","date":"19\/09\/2024","format":false,"excerpt":"This is the current list of subjects (groups of data models) related to Smart cities available at GitHub. Every link takes you to a group of folders, each one contains the description of the data model in the directory \/doc\/, there are examples of integrations in the directory \/code\/ and\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages\/2312","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/comments?post=2312"}],"version-history":[{"count":1,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages\/2312\/revisions"}],"predecessor-version":[{"id":2313,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages\/2312\/revisions\/2313"}],"wp:attachment":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/media?parent=2312"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}