Polishing.

See gh-247

spring-vault-core/src/main/java/org/springframework/vault/core/VaultKeyValueAccessor.java

@@ -42,10 +42,11 @@ import org.springframework.web.client.RestOperations;
 import org.springframework.web.client.RestTemplate;
 
 /**
- * Base class for {@link VaultVersionedKeyValueTemplate} and other Vault KV-accessing
- * helpers, defining common
+ * Base class for {@link VaultVersionedKeyValueTemplate} and {@link VaultKeyValueTemplate}
+ * and other Vault KV-accessing helpers, defining common
  * <p/>
- * Not intended to be used directly. See {@link VaultVersionedKeyValueTemplate}.
+ * Not intended to be used directly. See {@link VaultVersionedKeyValueTemplate} and
+ * {@link VaultKeyValueTemplate}.
  *
  * @author Mark Paluch
  * @since 2.1
@@ -151,7 +152,7 @@ public abstract class VaultKeyValueAccessor implements VaultKeyValueOperationsSu
 	}
 
 	@Nullable
-	<T> T doRead(String path, ParameterizedTypeReference<T> typeReference) {
+	private <T> T doRead(String path, ParameterizedTypeReference<T> typeReference) {
 
 		return doRead((restOperations, httpEntity) -> {
 			return restOperations.exchange(path, HttpMethod.GET, httpEntity,

spring-vault-core/src/main/java/org/springframework/vault/core/VaultKeyValueOperations.java

@@ -23,9 +23,14 @@ import org.springframework.vault.support.VaultResponseSupport;
  * Interface that specifies a basic set of Vault operations using Vault's Key/Value secret
  * backend. Paths used in this operations interface are relative and outgoing requests
  * prepend paths with the according operation-specific prefix.
+ * <p/>
+ * This API supports both, versioned and unversioned key-value backends. Versioned usage
+ * is limited as updates requiring compare-and-set (CAS) are not possible. Use
+ * {@link VaultVersionedKeyValueOperations} in such cases instead.
  *
  * @author Mark Paluch
  * @since 2.1
+ * @see VaultVersionedKeyValueOperations
  */
 public interface VaultKeyValueOperations extends VaultKeyValueOperationsSupport {
 

spring-vault-core/src/main/java/org/springframework/vault/core/VaultVersionedKeyValueOperations.java

@@ -34,6 +34,7 @@ import org.springframework.vault.support.Versioned.Version;
  *
  * @author Mark Paluch
  * @since 2.1
+ * @see VaultKeyValueOperations
  */
 public interface VaultVersionedKeyValueOperations extends VaultKeyValueOperationsSupport {
 

src/main/asciidoc/new-features.adoc

@@ -4,7 +4,7 @@
 [[new-features.2-1-0]]
 === What's new in Spring Vault 2.1
 * <<vault.authentication.gcpgce,GCP Compute>> and <<vault.authentication.gcpiam,GCP IAM>> authentication.
-* Template API support for versioned Key/Value backends.
+* Template API support for versioned and unversioned Key/Value backends.
 
 [[new-features.2-0-0]]
 === What's new in Spring Vault 2.0