From fd3aa697c329ca7cb402b7c8c0c7855659ca83e8 Mon Sep 17 00:00:00 2001
From: Mark Paluch <mpaluch@vmware.com>
Date: Tue, 7 Sep 2021 09:17:50 +0200
Subject: [PATCH] Move documentation bits regarding AbstractAuditable into
 JPA-specific documentation.

Closes #2284
---
 src/main/asciidoc/jpa.adoc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/main/asciidoc/jpa.adoc b/src/main/asciidoc/jpa.adoc
index 1abb6f8d7..f57182a3f 100644
--- a/src/main/asciidoc/jpa.adoc
+++ b/src/main/asciidoc/jpa.adoc
@@ -988,9 +988,13 @@ interface UserRepository extends Repository<User, Long> {
 ====
 
 :leveloffset: +1
+
 include::{spring-data-commons-docs}/auditing.adoc[]
+
 :leveloffset: -1
 
+There is also a convenience base class, `AbstractAuditable`, which you can extend to avoid the need to manually implement the interface methods. Doing so increases the coupling of your domain classes to Spring Data, which might be something you want to avoid. Usually, the annotation-based way of defining auditing metadata is preferred as it is less invasive and more flexible.
+
 [[jpa.auditing]]
 == JPA Auditing