Repository: incubator-beam-site Updated Branches: refs/heads/asf-site 0c4bff77b -> 60791ca2e
Update download page to specify backward-compatibility guarantees Project: http://git-wip-us.apache.org/repos/asf/incubator-beam-site/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-beam-site/commit/7f7a8b2d Tree: http://git-wip-us.apache.org/repos/asf/incubator-beam-site/tree/7f7a8b2d Diff: http://git-wip-us.apache.org/repos/asf/incubator-beam-site/diff/7f7a8b2d Branch: refs/heads/asf-site Commit: 7f7a8b2d3e8672516627b6949d0cbafa44e13fc5 Parents: 0c4bff7 Author: Davor Bonaci <[email protected]> Authored: Mon Nov 21 13:36:18 2016 -0800 Committer: Davor Bonaci <[email protected]> Committed: Mon Nov 21 17:03:12 2016 -0800 ---------------------------------------------------------------------- src/get-started/downloads.md | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-beam-site/blob/7f7a8b2d/src/get-started/downloads.md ---------------------------------------------------------------------- diff --git a/src/get-started/downloads.md b/src/get-started/downloads.md index 0015d77..af8506a 100644 --- a/src/get-started/downloads.md +++ b/src/get-started/downloads.md @@ -33,19 +33,32 @@ Additionally, you may want to depend on additional SDK modules, such as IO connectors or other extensions, and additional runners to execute your pipeline at scale. -## Release Notes +## API Stability + +Apache Beam uses [semantic versioning](http://semver.org/). Version numbers use the form `major.minor.incremental` and are incremented as follows: + +* major version for incompatible API changes +* minor version for new functionality added in a backward-compatible manner +* incremental version for forward-compatible bug fixes + +Please note that APIs marked [`@Experimental`]({{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/org/apache/beam/sdk/annotations/Experimental.html) +may change at any point and are not guaranteed to remain compatible across versions. + +Additionally, any API may change before the first stable release, i.e., between versions denoted `0.x.y`. + +## Releases ### 0.3.0-incubating -[Source code download](https://www.apache.org/dyn/closer.cgi?filename=incubator/beam/0.3.0-incubating/apache-beam-0.3.0-incubating-source-release.zip&action=download) +Official [source code download](https://www.apache.org/dyn/closer.cgi?filename=incubator/beam/0.3.0-incubating/apache-beam-0.3.0-incubating-source-release.zip&action=download). -* Release notes are available [in JIRA](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319527&version=12338051). +[Release notes](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319527&version=12338051). ### 0.2.0-incubating -[Source code download](https://www.apache.org/dyn/closer.cgi?filename=incubator/beam/0.2.0-incubating/apache-beam-0.2.0-incubating-source-release.zip&action=download) +Official [source code download](https://www.apache.org/dyn/closer.cgi?filename=incubator/beam/0.2.0-incubating/apache-beam-0.2.0-incubating-source-release.zip&action=download). -* Release notes are available [in JIRA](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319527&version=12335766). +[Release notes](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319527&version=12335766). ### 0.1.0-incubating -[Source code download](https://www.apache.org/dyn/closer.cgi?filename=incubator/beam/0.1.0-incubating/apache-beam-0.1.0-incubating-source-release.zip&action=download) +Official [source code download](https://www.apache.org/dyn/closer.cgi?filename=incubator/beam/0.1.0-incubating/apache-beam-0.1.0-incubating-source-release.zip&action=download). -* The first incubating release of Apache Beam. +The first incubating release of Apache Beam.
