Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
docs:version_numbers [2013/12/03 20:25]
matthias [Version-Numbering after 1.0]
docs:version_numbers [2014/05/06 18:57] (current)
darts
Line 1: Line 1:
 ====== PirateBox version-numbering ====== ====== PirateBox version-numbering ======
 ===== Version-Numbering after 1.0 ===== ===== Version-Numbering after 1.0 =====
-With the release of PirateBox 1.0.0 step over a version ​schema, which is quite common across open-source software+With the release of PirateBox 1.0.0, we have instituted ​new version-numbering scheme:
  
   * z.y.x   * z.y.x
Line 9: Line 9:
   * OpenWRT packages z.y.x-n   * OpenWRT packages z.y.x-n
     * n is the release level of OpenWRT packages.     * n is the release level of OpenWRT packages.
-      * If there is a core issue within the OpenWRT runtime scripts, that number will be raized.+      * If there is a core issue within the OpenWRT runtime scripts, that version ​number will be increased.
  
-In short: **If we release ​a 1.0.0 to 1.0.1 release, you don't need to reinstall the complete ​OpenWRT box.**+In shortchange from 1.0.0 to 1.0.1 will not require a complete ​re-install.
  
-In the future ​we are following ​these rules upon the versioning schema:+Moving forward, ​we will apply the following rules to the PirateBox version numbering:
  
-  * z.y. Version are compatible ​to each other, ​that means that +  * z.y. Version are compatible ​with each other, ​which means: 
-    * If we release a new x Bugfix release ( 1.0.0 -> 1.0.1 ), then you can update a running PirateBox ​on [[openwrt:​update_image_only|OpenWRT ​with the updatePB ​command]].+    * If we release a new x Bugfix release ( 1.0.0 -> 1.0.1 ), then you can update a running PirateBox with a simple update ​command.
     * You don't need to reinstall the OpenWRT package     * You don't need to reinstall the OpenWRT package
     * We won't publish a new x release on OpenWRT without an issue within the scripts     * We won't publish a new x release on OpenWRT without an issue within the scripts
-    * On other plattforms ​you have to exchange the complete scripts or adjust manually +    * On other platforms ​you have to exchange the complete scripts or adjust manually 
-  * Try to avoid unecessary reinstallation ​on OpenWRT-Systems +  * Try to avoid unnecessary re-installation ​on OpenWRT-Systems 
-    * Raize Package-Version as less as possible+    * Raise Package-Version as little ​as possible
     * Do not align OpenWRT package versions against PirateBox-Core-package versions (see above)     * Do not align OpenWRT package versions against PirateBox-Core-package versions (see above)
   * z Releases deliver new core features, that changes backward capabilities significantly.   * z Releases deliver new core features, that changes backward capabilities significantly.
- 
  
 ===== History ===== ===== History =====
  
-Before PirateBox release 0.6.3 on OpenWRT systems, the version-numbers were confusing. That is an result of supporting the following ​plattforms ​having its own special dependencies:​+Before PirateBox release 0.6.3 on OpenWRT systems, the version-numbering system was confusing. That is result of supporting the following ​platforms ​having its own special dependencies:​
  
   * OpenWRT - Special installation scripts   * OpenWRT - Special installation scripts
Line 34: Line 33:
   * RaspberryPI - StartUp managemend sligtly different   * RaspberryPI - StartUp managemend sligtly different
  
- With 0.6 release, we tried to tidy up the version numbers and align the first two digits, to a major release and only the last digit/​letter may differ depending on system individual issues. ​+With the 0.6 release, we cleaned ​up the version numbers and aligned ​the first two digits, to a major release and only the last digit/​letter may differ depending on system individual issues. ​
  
   * 0.6   => Release Step   * 0.6   => Release Step
   * 0.6 N => n = a letter ​ core script ​ fix-level   * 0.6 N => n = a letter ​ core script ​ fix-level
   * 0.6.1 => OpenWRT(System) package Fix-Level   * 0.6.1 => OpenWRT(System) package Fix-Level
- 
-One release-step is compatible to the decent fixes which follow up.