semver: update layout
This commit is contained in:
parent
9641d4f2fb
commit
108cb2cc41
|
@ -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
|
||||||
|
|
67
semver.md
67
semver.md
|
@ -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>
|
||||||
|
|
Loading…
Reference in New Issue