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 {
code {
td:first-child > code {
font-size: 1em;
padding: 5px 6px;
padding-left: 8px; // compensation

View File

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