Skip to content

Commit cd6fb50

Browse files
committed
Merge remote-tracking branch 'remotes/upstream/alpha' into pr-migrations
2 parents 41d906b + 653d257 commit cd6fb50

File tree

2 files changed

+40
-17
lines changed

2 files changed

+40
-17
lines changed

CONTRIBUTING.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@
2222
- [Pull Request](#pull-request)
2323
- [Breaking Change](#breaking-change)
2424
- [Merging](#merging)
25+
- [Versioning](#versioning)
2526
- [Code of Conduct](#code-of-conduct)
2627

2728
## Contributing
@@ -346,6 +347,27 @@ The following guide is for anyone who merges a contributor pull request into the
346347
- A contributor pull request must be merged into the working branch using `Squash and Merge`, to create a single commit message that describes the change.
347348
- A release branch or the default branch must be merged into another release branch using `Merge Commit`, to preserve each individual commit message that describes its respective change.
348349
350+
## Versioning
351+
352+
> The following versioning system is applied since Parse Server 5.0.0 and does not necessarily apply to previous releases.
353+
354+
Parse Server follows [semantic versioning](https://semver.org) with a flavor of [calendric versioning](https://calver.org). Semantic versioning makes Parse Server easy to upgrade because breaking changes only occur in major releases. Calendric versioning gives an additional sense of how old a Parse Server release is and allows for Long-Term Support of previous major releases.
355+
356+
Example version: `5.0.0-alpha.1`
357+
358+
Syntax: `[major]`**.**`[minor]`**.**`[patch]`**-**`[pre-release-label]`**.**`[pre-release-increment]`
359+
360+
- The `major` version increments with the first release of every year and may include changes that are *not backwards compatible*.
361+
- The `minor` version increments during the year and may include new features or improvements of existing features that are backwards compatible.
362+
- The `patch` version increments during the year and may include bug fixes that are backwards compatible.
363+
- The `pre-release-label` is optional for pre-release versions such as:
364+
- `-alpha` (likely to contain bugs, likely to change in features until release)
365+
- `-beta` (likely to contain bugs, no change in features until release)
366+
- The `[pre-release-increment]` is a number that increments with every new version of a pre-release
367+
368+
Exceptions:
369+
- The `major` version may increment during the year in the unlikely event that a breaking change is so urgent that it cannot wait for the next yearly release. An example would be a vulnerability fix that leads to an unavoidable breaking change. However, security requirements depend on the application and not every vulnerability may affect every deployment, depending on the features used. Therefore we usually prefer to deprecate insecure functionality and introduce the breaking change following our [deprecation policy](#deprecation-policy).
370+
349371
## Code of Conduct
350372
351373
This project adheres to the [Contributor Covenant Code of Conduct](https://github.com/parse-community/parse-server/blob/master/CODE_OF_CONDUCT.md). By participating, you are expected to honor this code.

README.md

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -108,31 +108,32 @@ Before you start make sure you have installed:
108108
#### Node.js
109109
Parse Server is continuously tested with the most recent releases of Node.js to ensure compatibility. We follow the [Node.js Long Term Support plan](https://github.com/nodejs/Release) and only test against versions that are officially supported and have not reached their end-of-life date.
110110

111-
| Version | Latest Version | End-of-Life Date | Compatibility |
112-
|------------|----------------|------------------|--------------------|
113-
| Node.js 12 | 12.22.7 | April 2022 | ✅ Fully compatible |
114-
| Node.js 14 | 14.18.1 | April 2023 | ✅ Fully compatible |
115-
| Node.js 15 | 15.14.0 | June 2021 | ✅ Fully compatible |
111+
| Version | Latest Version | End-of-Life | Compatible |
112+
|------------|----------------|-------------|---------------|
113+
| Node.js 12 | 12.22.7 | April 2022 | ✅ Yes |
114+
| Node.js 14 | 14.18.1 | April 2023 | ✅ Yes |
115+
| Node.js 15 | 15.14.0 | June 2021 | ✅ Yes |
116+
| Node.js 16 | 16.x.x | April 2024 | ❌ Not tested |
116117

117118
#### MongoDB
118119
Parse Server is continuously tested with the most recent releases of MongoDB to ensure compatibility. We follow the [MongoDB support schedule](https://www.mongodb.com/support-policy) and only test against versions that are officially supported and have not reached their end-of-life date.
119120

120-
| Version | Latest Version | End-of-Life Date | Compatibility |
121-
|-------------|----------------|------------------|--------------------|
122-
| MongoDB 4.0 | 4.0.27 | April 2022 | ✅ Fully compatible |
123-
| MongoDB 4.2 | 4.2.17 | TBD | ✅ Fully compatible |
124-
| MongoDB 4.4 | 4.4.10 | TBD | ✅ Fully compatible |
125-
| MongoDB 5.0 | 5.0.3 | January 2024 | ✅ Fully compatible |
121+
| Version | Latest Version | End-of-Life | Compatible |
122+
|-------------|----------------|--------------|------------|
123+
| MongoDB 4.0 | 4.0.27 | April 2022 | ✅ Yes |
124+
| MongoDB 4.2 | 4.2.17 | TBD | ✅ Yes |
125+
| MongoDB 4.4 | 4.4.10 | TBD | ✅ Yes |
126+
| MongoDB 5.0 | 5.0.3 | January 2024 | ✅ Yes |
126127

127128
#### PostgreSQL
128129
Parse Server is continuously tested with the most recent releases of PostgreSQL and PostGIS to ensure compatibility, using [PostGIS docker images](https://registry.hub.docker.com/r/postgis/postgis/tags?page=1&ordering=last_updated). We follow the [PostgreSQL support schedule](https://www.postgresql.org/support/versioning) and [PostGIS support schedule](https://www.postgis.net/eol_policy/) and only test against versions that are officially supported and have not reached their end-of-life date. Due to the extensive PostgreSQL support duration of 5 years, Parse Server drops support if a version is older than 3.5 years and a newer version has been available for at least 2.5 years.
129130

130-
| Version | PostGIS Version | End-of-Life Date | Parse Server Support End | Compatibility |
131-
|-------------|-----------------|------------------|--------------------------|--------------------|
132-
| Postgres 11 | 3.0, 3.1 | November 2023 | April 2022 |Fully compatible |
133-
| Postgres 12 | 3.1 | November 2024 | April 2023 |Fully compatible |
134-
| Postgres 13 | 3.1 | November 2025 | April 2024 |Fully compatible |
135-
| Postgres 14 | 3.1 | November 2026 | April 2025 |Fully compatible |
131+
| Version | PostGIS Version | End-of-Life | Parse Server Support End | Compatible |
132+
|-------------|-----------------|---------------|--------------------------|------------|
133+
| Postgres 11 | 3.0, 3.1 | November 2023 | April 2022 |Yes |
134+
| Postgres 12 | 3.1 | November 2024 | April 2023 |Yes |
135+
| Postgres 13 | 3.1 | November 2025 | April 2024 |Yes |
136+
| Postgres 14 | 3.1 | November 2026 | April 2025 |Yes |
136137

137138
### Locally
138139
```bash

0 commit comments

Comments
 (0)