You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lens.apache.org by am...@apache.org on 2015/04/15 21:47:38 UTC

[14/30] incubator-lens git commit: LENS-10: Updates branching, versioning and compatibility strategies in Apache Lens(Amareshwari Sriramadasu via prongs)

LENS-10: Updates branching, versioning and compatibility strategies in Apache Lens(Amareshwari Sriramadasu via prongs)


Project: http://git-wip-us.apache.org/repos/asf/incubator-lens/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-lens/commit/4639f6bc
Tree: http://git-wip-us.apache.org/repos/asf/incubator-lens/tree/4639f6bc
Diff: http://git-wip-us.apache.org/repos/asf/incubator-lens/diff/4639f6bc

Branch: refs/heads/master
Commit: 4639f6bcac81151bc0fe827cc01dad45e36b1261
Parents: 6ace656
Author: Amareshwari Sriramadasu <am...@apache.org>
Authored: Fri Feb 13 21:20:44 2015 +0530
Committer: Amareshwari Sriramadasu <am...@apache.org>
Committed: Tue Feb 17 17:10:16 2015 +0530

----------------------------------------------------------------------
 src/site/apt/releases/compatibility.apt   | 47 ++++++++++++++++++++++++++
 src/site/apt/releases/release-history.apt | 27 +++++++++++++++
 2 files changed, 74 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/4639f6bc/src/site/apt/releases/compatibility.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/releases/compatibility.apt b/src/site/apt/releases/compatibility.apt
new file mode 100644
index 0000000..453c57e
--- /dev/null
+++ b/src/site/apt/releases/compatibility.apt
@@ -0,0 +1,47 @@
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements.  See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership.  The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License.  You may obtain a copy of the License at
+~~
+~~   http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied.  See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+~~
+
+Compatibility in Apache Lens
+
+  Apache Lens tries to offer backward compatibility across releases with respect to the following
+
+  * <<lens-api>> module dependency :
+  {{{http://lens.incubator.apache.org/apidocs/index.html} API for org.apache.lens.api.*}}
+
+  * REST api provided : {{{http://lens.incubator.apache.org/rest.html} Published REST api}}
+
+  * Configuration options provided at {{{../user/client-config.html} Client configuration}},
+  {{{../user/olap-query-conf.html} OLAP query configuration}} and
+  {{{../admin/config-server.html} Server configuration}}.
+
+  * Deployment stack : Published at {{{../admin/deployment.html} Suggested deployment}}
+
+  []
+
+
+  For any changes proposed in <<lens-api>>, <<REST api>> and <<configuration options>>, Apache Lens community will do
+  atleast one release with backward compatibility making current usage deprecated.
+
+  If there are any incompatibilities with respect to the above in any release, the major version will be called out as
+  incompatible with earlier version and tools/documentation will be provided to upgrade to newer version.
+
+  The api <org.apache.lens.client.*> and <org.apache.lens.server.api.*>  are still evolving, once they are stable, they
+  will be added to the above list.
+
+  See {{{./release-history.html} all releases table}} for all release details, compatibility tools provided.

http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/4639f6bc/src/site/apt/releases/release-history.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/releases/release-history.apt b/src/site/apt/releases/release-history.apt
new file mode 100644
index 0000000..f5f6139
--- /dev/null
+++ b/src/site/apt/releases/release-history.apt
@@ -0,0 +1,27 @@
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements.  See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership.  The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License.  You may obtain a copy of the License at
+~~
+~~   http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied.  See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+~~
+All Apache Lens releases
+
+  Below table captures releases, release documentation, their compatibility and tools provided for incompatible changes.
+
+*--+--+---+--+--+--+--+
+|Release version|Major features|Release documentation|Release Notes|Download|Incompatibilities|More Info |
+*--+--+---+--+--+--+--+
+|2.0.0| First release in Apache| {{{../versions/2.0.0-incubating/index.html} 2.0.x-incubating docs}} | {{{https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12315923&version=12328990} 2.0 release notes}}| {{{http://archive.apache.org/dist/incubator/lens/2.0-incubating/} Download}} | - | - |
+*--+--+---+--+--+--+--+
\ No newline at end of file