3879c0670b4cdb0231b20b5b1cb6b6864dc06f96
[yangtools.git] / yang / yang-parser-impl / src / test / resources / semantic-version / position / position-head / semantic-version.yang
1 module semantic-version {
2     sv:semantic-version "0.0.1";
3
4     namespace "urn:opendaylight:yang:extension:semantic-version";
5     prefix sv;
6     yang-version 1;
7
8     revision 2016-02-02 {
9         description "Initial verison";
10     }
11
12     extension semantic-version {
13         argument "semantic-version" {
14             yin-element false;
15         }
16         description
17             "The OpenConfig version number for the module. This is
18             expressed as a semantic version number of the form:
19               x.y.z
20             where:
21               * x corresponds to the major version,
22               * y corresponds to a minor version,
23               * z corresponds to a patch version.
24             This version corresponds to the model file within which it is
25             defined, and does not cover the whole set of OpenConfig models.
26             Where several modules are used to build up a single block of
27             functionality, the same module version is specified across each
28             file that makes up the module.
29
30             A major version number of 0 indicates that this model is still
31             in development (whether within OpenConfig or with industry
32             partners), and is potentially subject to change.
33
34             Following a release of major version 1, all modules will
35             increment major revision number where backwards incompatible
36             changes to the model are made.
37
38             The minor version is changed when features are added to the
39             model that do not impact current clients use of the model.
40
41             The patch-level version is incremented when non-feature changes
42             (such as bugfixes or clarifications to human-readable
43             descriptions that do not impact model functionality) are made
44             that maintain backwards compatibility.
45
46             The version number is stored in the module meta-data.";
47     }
48 }