semver: update layout

This commit is contained in:
Rico Sta. Cruz 2017-08-30 01:44:38 +08:00
parent 9641d4f2fb
commit 108cb2cc41
No known key found for this signature in database
GPG Key ID: CAAD38AE2962619A
2 changed files with 40 additions and 29 deletions

View File

@ -60,7 +60,7 @@
} }
.MarkdownBody table.-shortcuts { .MarkdownBody table.-shortcuts {
code { td:first-child > code {
font-size: 1em; font-size: 1em;
padding: 5px 6px; padding: 5px 6px;
padding-left: 8px; // compensation padding-left: 8px; // compensation

View File

@ -1,12 +1,18 @@
--- ---
title: Semver title: Semver
layout: 2017/sheet
updated: 201708
weight: -3
--- ---
Given a version number `MAJOR.MINOR.PATCH`: ### Semver
* `MAJOR` = incompatible API changes. Given a version number `MAJOR.MINOR.PATCH`:
* `MINOR` = add functionality. (backwards-compatible) {: .-setup}
* `PATCH` = bug fixes. (backwards-compatible)
| `MAJOR` | incompatible API changes |
| `MINOR` | add functionality (backwards-compatible) |
| `PATCH` | bug fixes (backwards-compatible) |
### Simple ranges ### Simple ranges
@ -20,23 +26,26 @@ Note that suffixed versions (`1.2.3-rc1`) are not matched.
### Ranges ### Ranges
~1.2.3 : is >=1.2.3 <1.3.0 | Range | Description | Notes |
| --- | --- | --- |
^1.2.3 : is >=1.2.3 <2.0.0 | `~1.2.3` | is `>=1.2.3 <1.3.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.3` | is `>=1.2.3 <2.0.0` | |
| `^0.2.3` | is `>=0.2.3 <0.3.0` | (0.x.x is special) |
^1.2 : is >=1.2.0 <2.0.0 (like ^1.2.0) | `^0.0.1` | is `=0.0.1` | (0.0.x is special) |
~1.2 : is >=1.2.0 <1.3.0 (like ~1.2.0) | --- | --- | --- |
| `^1.2` | is `>=1.2.0 <2.0.0` | (like ^1.2.0) |
^1 : is >=1.0.0 <2.0.0 | `~1.2` | is `>=1.2.0 <1.3.0` | (like ~1.2.0) |
~1 : same | --- | --- | --- |
1.x : same | `^1` | is `>=1.0.0 <2.0.0` | |
1.* : same | `~1` | same | |
1 : same | `1.x` | same | |
| `1.*` | same | |
* : any version | `1` | same | |
x : same | --- | --- | --- |
| `*` | any version | |
| `x` | same | |
{: .-shortcuts}
### Pre-releases ### Pre-releases
@ -44,12 +53,14 @@ Note that suffixed versions (`1.2.3-rc1`) are not matched.
### Explanation ### Explanation
* `^` means "compatible with" | `^` | means "compatible with" |
* `~` means "reasonably close to" | `~` | means "reasonably close to" |
* `0.x.x` is for "initial development" | `0.x.x` | is for "initial development" |
* `1.x.x` means public API is defined | `1.x.x` | means public API is defined |
{: .-shortcuts}
### References ## References
{: .-one-column}
* http://semver.org/ * <http://semver.org/>
* https://www.npmjs.org/doc/misc/semver.html * <https://www.npmjs.org/doc/misc/semver.html>