diff --git a/pom.xml b/pom.xml
index f0f583b51e..2779e4af95 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
 
 	<groupId>org.springframework.data</groupId>
 	<artifactId>spring-data-commons</artifactId>
-	<version>2.5.0-SNAPSHOT</version>
+	<version>2.5.0-GH-2338-SNAPSHOT</version>
 
 	<name>Spring Data Core</name>
 
@@ -339,7 +339,7 @@
 			<version>0.1.4</version>
 			<scope>test</scope>
 		</dependency>
-		
+
 		<dependency>
 			<groupId>org.jmolecules.integrations</groupId>
 			<artifactId>jmolecules-spring</artifactId>
diff --git a/src/main/java/org/springframework/data/domain/Persistable.java b/src/main/java/org/springframework/data/domain/Persistable.java
index 8a89fdbda2..a084196622 100644
--- a/src/main/java/org/springframework/data/domain/Persistable.java
+++ b/src/main/java/org/springframework/data/domain/Persistable.java
@@ -19,10 +19,16 @@
 
 /**
  * Simple interface for entities.
+ * <p>
+ * Note that methods declared in this interface ({@link #getId()} and {@link #isNew()}) become property accessors when
+ * implementing this interface in combination with
+ * {@link org.springframework.data.annotation.AccessType @AccessType(PROPERTY)}. Either of these can be marked as
+ * transient when annotated with {@link org.springframework.data.annotation.Transient @Transient}.
  *
  * @param <ID> the type of the identifier
  * @author Oliver Gierke
  * @author Christoph Strobl
+ * @author Mark Paluch
  */
 public interface Persistable<ID> {