devel-versioning.rst
changeset 1057 8e946a8709e0
parent 1042 dd197cbdaf21
child 1058 cd1062303157
equal deleted inserted replaced
1056:f4106c3de31e 1057:8e946a8709e0
    69 
    69 
    70 Its conventional to have at least a major and minor number.
    70 Its conventional to have at least a major and minor number.
    71 
    71 
    72 Prefixing version with a "v" seems to be less common.
    72 Prefixing version with a "v" seems to be less common.
    73 
    73 
       
    74 Versioning for libraries/modules/components.
       
    75 ============================================
       
    76 
    74 Major version component.
    77 Major version component.
    75 ------------------------
    78 ------------------------
    76 
    79 
    77 Major number change means that fundamental change made in the architecture of
    80 Major number change means that fundamental change made in the architecture of
    78 the system the new version is incompatible with the old one, upgrade between
    81 the system the new version is incompatible with the old one, upgrade between
   110  * b (beta) means most severe bugs are fixed and end users can start trying the
   113  * b (beta) means most severe bugs are fixed and end users can start trying the
   111    release.
   114    release.
   112  * rc (release candidate) are believed to meet all of the criteria for release
   115  * rc (release candidate) are believed to meet all of the criteria for release
   113    and can be installed on test instances of production systems.
   116    and can be installed on test instances of production systems.
   114 
   117 
       
   118 Versioning for products.
       
   119 ========================
       
   120 
       
   121 Versioning for products differ from versioning for libraries.
       
   122 
       
   123 Product is a set of conponents fixed to some versions. Components can be
       
   124 switches as written for library versioning:
       
   125 
       
   126  * Any fix release interchanged.
       
   127  * Any minor release interchanged starting from some minor.
       
   128  * Major release does not interchanged at all.
       
   129 
   115 Release build version data.
   130 Release build version data.
   116 ===========================
   131 ===========================
   117 
   132 
   118  * Build number.
   133  * Build number.
   119  * Build date.
   134  * Build date.
   120  * Build version.
   135  * VCS revision.
   121  * Branch-tag used.
   136  * Branch-tag used.
   122  * Overnight build (Y/N).
   137  * Overnight build (Y/N).
   123  * QA tested (Y/N).
   138  * QA tested (Y/N).
   124  * QA test results (Pass/Fail).
   139  * QA test results (Pass/Fail).
   125  * Location of full logs.
   140  * Location of full logs.