kudu git commit: docs: Put finishing touches on 1.6.0 release notes

[mp...@apache.org]

Repository: kudu
Updated Branches:
  refs/heads/branch-1.6.x 0cd54e0e8 -> f6b97c7c7


docs: Put finishing touches on 1.6.0 release notes

Change-Id: Ibe206463c182aedd58a62e7a7163240baa12957d
Reviewed-on: http://gerrit.cloudera.org:8080/8723
Reviewed-by: Mike Percy <mp...@apache.org>
Tested-by: Mike Percy <mp...@apache.org>
Reviewed-on: http://gerrit.cloudera.org:8080/8741


Project: http://git-wip-us.apache.org/repos/asf/kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/kudu/commit/f6b97c7c
Tree: http://git-wip-us.apache.org/repos/asf/kudu/tree/f6b97c7c
Diff: http://git-wip-us.apache.org/repos/asf/kudu/diff/f6b97c7c

Branch: refs/heads/branch-1.6.x
Commit: f6b97c7c754a4a6f975d9b7249aab973996b7d8f
Parents: 0cd54e0
Author: Mike Percy <mp...@apache.org>
Authored: Fri Dec 1 18:29:25 2017 -0800
Committer: Mike Percy <mp...@apache.org>
Committed: Sat Dec 2 05:32:16 2017 +0000

----------------------------------------------------------------------
 docs/release_notes.adoc | 61 ++++++++++++++++++++++++--------------------
 1 file changed, 33 insertions(+), 28 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/kudu/blob/f6b97c7c/docs/release_notes.adoc
----------------------------------------------------------------------
diff --git a/docs/release_notes.adoc b/docs/release_notes.adoc
index 002910e..5a4adfa 100644
--- a/docs/release_notes.adoc
+++ b/docs/release_notes.adoc
@@ -31,7 +31,17 @@
 [[rn_1.6.0_upgrade_notes]]
 == Upgrade Notes
 
-* TBD
+* Upgrading directly from Kudu 1.5.0 is supported and no special upgrade steps
+  are required. A rolling upgrade may work, however it has not been tested.
+  When upgrading Kudu, it is recommended to first shut down all Kudu processes
+  across the cluster, then upgrade the software on all servers, then restart
+  the Kudu processes on all servers in the cluster.
+
+[[rn_1.6.0_obsoletions]]
+== Obsoletions
+
+* Support for Spark 1 (kudu-spark_2.10) has been **removed** in Kudu 1.6.0 and
+  now only Spark 2 is supported. Spark 1 support was deprecated in Kudu 1.5.0.
 
 [[rn_1.6.0_deprecations]]
 == Deprecations
@@ -39,9 +49,6 @@
 * Support for Java 7 has been deprecated since Kudu 1.5.0 and may be removed in
   the next major release.
 
-* Support for Spark 1 (kudu-spark_2.10) has been deprecated since Kudu 1.6.0
-  (TBD: no longer supported?)
-
 [[rn_1.6.0_new_features]]
 == New features
 
@@ -67,16 +74,16 @@
   settings: `--webserver_tls_ciphers` and `--webserver_tls_min_protocol`.
   These flags allow the advertised TLS ciphers and TLS protocol versions to be
   configured. Additionally, the webserver now excludes insecure legacy ciphers
-  by default.
-  (link:https://issues.apache.org/jira/browse/KUDU-2190[KUDU-2190]).
+  by default
+  (see link:https://issues.apache.org/jira/browse/KUDU-2190[KUDU-2190]).
 
 == Optimizations and improvements
 
 * Kudu servers can now tolerate short interruptions in NTP clock
   synchronization. NTP synchronization is still required when any Kudu daemon
   starts up. If NTP synchronization is not available, diagnostic information
-  is now logged to help pinpoint the issue.
-  (link:https://issues.apache.org/jira/browse/KUDU-1578[KUDU-1578])
+  is now logged to help pinpoint the issue
+  (see link:https://issues.apache.org/jira/browse/KUDU-1578[KUDU-1578]).
 
 * Tablet server startup time has been improved significantly on servers
   containing large numbers of blocks.
@@ -99,8 +106,8 @@
 
 * Kudu may now be configured to ignore system-wide auth_to_local mappings
   configured in /etc/krb5.conf by setting the configuration flag
-  `--use_system_auth_to_local=false`.
-  (link:https://issues.apache.org/jira/browse/KUDU-2198[KUDU-2198])
+  `--use_system_auth_to_local=false`
+  (see link:https://issues.apache.org/jira/browse/KUDU-2198[KUDU-2198]).
 
 * The performance of the compaction scheduler has been improved. In
   previous versions, certain types of time series workloads were found to
@@ -112,16 +119,16 @@
 
 * Tablet servers now consider the health of all replicas of a tablet before
   deciding to evict one. This can improve stability of the Kudu cluster after
-  experiencing multiple simultaneous daemon failures.
-  (link:https://issues.apache.org/jira/browse/KUDU-2048[KUDU-2048])
+  experiencing multiple simultaneous daemon failures
+  (see link:https://issues.apache.org/jira/browse/KUDU-2048[KUDU-2048]).
 
 * Several performance improvements have been made to the Kudu master,
   particularly in concurrency of clients opening tables. This should improve
   performance in highly concurrent workloads.
 
 * The on-disk size metric for a tablet now includes all data and metadata.
-  Previously, it excluded WAL segments and consensus metadata.
-  (link:https://issues.apache.org/jira/browse/KUDU-1755[KUDU-1755])
+  Previously, it excluded WAL segments and consensus metadata
+  (see link:https://issues.apache.org/jira/browse/KUDU-1755[KUDU-1755]).
 
 * Added verbose mode for the 'kudu cluster ksck' command to enable output
   of detailed information on the cluster's metadata, even when no errors are
@@ -131,25 +138,25 @@
 == Fixed Issues
 
 * HybridTime timestamp propagation now works in the Java client when using scan
-  tokens. (link:https://issues.apache.org/jira/browse/KUDU-1411[KUDU-1411])
+  tokens (see link:https://issues.apache.org/jira/browse/KUDU-1411[KUDU-1411]).
 
 * Fixed an error message commonly found in tablet server logs indicating that
-  operations were being read "from the future".
-  (link:https://issues.apache.org/jira/browse/KUDU-1078[KUDU-1078])
+  operations were being read "from the future"
+  (see link:https://issues.apache.org/jira/browse/KUDU-1078[KUDU-1078]).
 
-* Tombstoned tablets no longer report metrics.
-  (link:https://issues.apache.org/jira/browse/KUDU-2044[KUDU-2044])
+* Tombstoned tablets no longer report metrics
+  (see link:https://issues.apache.org/jira/browse/KUDU-2044[KUDU-2044]).
 
 * Fixed a bug in the C++ client which could cause tablets to be erroneously
   pruned, or skipped, during certain scans, resulting in fewer results than
   expected being returned from queries. The bug only affected tables whose range
-  partition columns are a proper prefix of the primary key.
-  (link:https://issues.apache.org/jira/browse/KUDU-2173[KUDU-2173])
+  partition columns are a proper prefix of the primary key
+  (see link:https://issues.apache.org/jira/browse/KUDU-2173[KUDU-2173]).
 
 * Published Kudu Java artifacts are now fully compatible with JRE 7 and JRE 8.
   There was previously a bug in the release process which made them compatible
-  only with JRE 8.
-  (link:https://issues.apache.org/jira/browse/KUDU-2188[KUDU-2188])
+  only with JRE 8
+  (see link:https://issues.apache.org/jira/browse/KUDU-2188[KUDU-2188]).
 
 * Fixed a typo in the list of default TLS ciphers used by Kudu servers. As a
   result, two additional cipher suites are now available:
@@ -206,12 +213,10 @@ documentation.
 [[rn_1.6.0_contributors]]
 == Contributors
 
-Kudu 1.6 includes contributions from **TBD** people, including **TBD**
-first-time contributors:
-
-  - TODO: add list of new contributors
+Kudu 1.6 includes contributions from 14 people, including one
+first-time contributor, Hector Camarena.
 
-Thanks for helping to make Kudu what it is today!
+Thanks for helping to make Kudu even better!
 
 [[resources_and_next_steps]]
 == Resources