From 4cc053d6c3c2c91c5a1672d5aaf02b87597a484a Mon Sep 17 00:00:00 2001
From: "Rico Sta. Cruz" <hi@ricostacruz.com>
Date: Tue, 15 Jul 2014 15:56:24 +0800
Subject: [PATCH] Add semver.

---
 semver.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 semver.md

diff --git a/semver.md b/semver.md
new file mode 100644
index 000000000..867fa4ffe
--- /dev/null
+++ b/semver.md
@@ -0,0 +1,56 @@
+---
+title: Semver
+layout: default
+---
+
+Given a version number `MAJOR.MINOR.PATCH`:
+
+ * `MAJOR` = incompatible API changes.
+ * `MINOR` = add functionality. (backwards-compatible)
+ * `PATCH` = bug fixes. (backwards-compatible)
+
+### Simple ranges
+
+      1.2.3
+     =1.2.3
+     >1.2.3
+     <1.2.3
+    >=1.2.3
+
+Note that suffixed versions (`1.2.3-rc1`) are not matched.
+
+### Ranges
+
+    ~1.2.3    : is >=1.2.3 <1.3.0
+
+    ^1.2.3    : is >=1.2.3 <2.0.0
+    ^0.2.3    : is >=0.2.3 <0.3.0   (0.x.x is special)
+    ^0.0.1    : is  =0.0.1          (0.0.x is special)
+
+    ^1.2      : is >=1.2.0 <2.0.0   (like ^1.2.0)
+    ~1.2      : is >=1.2.0 <1.3.0   (like ~1.2.0)
+
+    ^1        : is >=1.0.0 <2.0.0
+    ~1        : same
+     1.x      : same
+     1.*      : same
+     1        : same
+
+    *         : any version
+    x         : same
+
+### Pre-releases
+
+    1.2.3-prerelease+build
+
+### Explanation
+
+ * `^` means "compatible with"
+ * `~` means "reasonably close to"
+ * `0.x.x` is for "initial development"
+ * `1.x.x` means public API is defined
+
+### References
+
+ * http://semver.org/
+ * https://www.npmjs.org/doc/misc/semver.html