When upgrading an application that uses Spring Data to 3.0, one recurrent problem is repository methods disappearing as the Repository interfaces have been restructured.

This is covered here: https://github.com/spring-projects/spring-data-commons/wiki/Spring-Data-2022.0-%28Turing%29-Release-Notes#new-crud-repository-interfaces-that-return-list-instead-of-iterable

It would be nice if the Spring Boot migration guide has a short blurb about spring data repositories so that it's easier to link to the section above.

Comment From: wilkinsona

We already link to the release notes for Spring Data. I'm not sure that it's practical for us to include in our release notes information, even if it's only short, about every third-party project and their breaking changes.

If the breaking changes and the necessary steps that have to be taken on update are hard to identify in Spring Data's release notes then I think it would be better if Spring Data's release notes were updated for the benefit of everyone, not just those coming to them through Boot's release notes.

Comment From: snicoll

Yes, I know that those are linked in that document. I am talking specifically about the Migration Guide. For "Data" it has a section that states:

The following changes should be reviewed if your application is working with data.

Further down, there is a section about Spring Security:

Spring Boot 3.0 has upgraded to Spring Security 6.0. Please review the Spring Security 6.0 migration guide in addition to the following section.

I don't know why one has a link, and not the other. Is this because Spring Security has "a migration guide" and Spring Data does not? As for making them more obvious, I think that's fine as they are front and center in the link you've shared. But, I think it would be helpful if they were linked from the migration guide as well.

Comment From: bclozel

I've added a link to the Spring Data release notes, as they list important changes about repository interface changes. This was noticed while working on a Spring Boot upgrade demo and this was the only noticeable hurdle in the upgrade path.