This is an automated email from the ASF dual-hosted git repository.
janh pushed a commit to branch branch-1
in repository https://gitbox.apache.org/repos/asf/hbase.git
The following commit(s) were added to refs/heads/branch-1 by this push:
new d3cf01d HBASE-22341 Extended the documentation for deprecating APIs
d3cf01d is described below
commit d3cf01d006a52c3848c2865b564fb71f50c79864
Author: Jan Hentschel <[email protected]>
AuthorDate: Tue Apr 30 12:26:44 2019 +0200
HBASE-22341 Extended the documentation for deprecating APIs
---
src/main/asciidoc/_chapters/upgrading.adoc | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/src/main/asciidoc/_chapters/upgrading.adoc
b/src/main/asciidoc/_chapters/upgrading.adoc
index 7fdc84f..1cb9bfd 100644
--- a/src/main/asciidoc/_chapters/upgrading.adoc
+++ b/src/main/asciidoc/_chapters/upgrading.adoc
@@ -71,7 +71,8 @@ In addition to the usual API versioning considerations HBase
has other compatibi
.Client API compatibility
* Allow changing or removing existing client APIs.
-* An API needs to deprecated for a major version before we will change/remove
it.
+* An API needs to be deprecated for a whole major version before we will
change/remove it.
+** An example: An API was deprecated in 2.0.1 and will be marked for deletion
in 4.0.0. On the other hand, an API deprecated in 2.0.0 can be removed in 3.0.0.
* APIs available in a patch version will be available in all later patch
versions. However, new APIs may be added which will not be available in earlier
patch versions.
* Example: A user using a newly deprecated api does not need to modify
application code with hbase api calls until the next major version.
