We already have documented all JPA and Hibernate annotations, and @DynamicUpdate explains that you should use @SelectBeforeUpdate for detached entities.