HDFS-5386: enhancements to docs