From: erikarn Date: Thu, 4 Apr 2013 00:00:34 +0000 (-0700) Subject: Created Version Policy (markdown) X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=af70ccb2c68132329ed7944337c31cec4a62f1f1;p=librecmc%2Fopen-ath9k-htc-firmware.wiki.git Created Version Policy (markdown) --- diff --git a/Version-Policy.md b/Version-Policy.md new file mode 100644 index 0000000..b81f535 --- /dev/null +++ b/Version-Policy.md @@ -0,0 +1,22 @@ += Why do we need a versioning policy? = + +Why? Because it's firmware and it's not tightly coupled to the driver. + +The firmware will be used by various projects for NIC support. It's not just for ath9k_htc - hopefully OpenBSD will adopt it soon; FreeBSD/NetBSD will adopt it as soon as there's a driver available. + +Since some downstream projects may wish to fork the github repository and do some of their own local development, each major and minor release will be a branch. + +The policy is thus: + +* No non-backwards compatible changes will occur on a major branch; +* Minor version numbers may introduce new features but they must be optional and default to the previous firmware behaviour; +* Major branch numbers may introduce non-backwards-compatible features. + +So: + +* Everything along the 1.x branch will be backwards compatible. +* There'll be a branch laid down for each minor revision released (eg 1.3, 1.4, 1.5). +* There'll be a tag laid down for each release along the minor revision (eg 1.3.1, 1.3.2, 1.3.3, etc.) which will match up with the binary firmware image that is released for public consumption. +* 1.3, 1.4, 1.5, etc can introduce new features, but they must be optional and default to the previous behaviour. + +Hopefully what will be pushed into linux-firmware.git will be the latest of each major release version. Ie, there will only be one "current" firmware release in linux-firmware.git for 1.x, 2.x, 3.x, etc. \ No newline at end of file