blaze-persistence icon indicating copy to clipboard operation
blaze-persistence copied to clipboard

Improve setup guide

Open programista10kpln opened this issue 9 months ago • 4 comments

This library is awesome and offers impressive features. However, setting it up and ensuring smooth operation proves to be quite challenging. Achieving proper integration with Spring Boot and Spring Data JPA requires numerous dependencies, which makes the process not only labor-intensive but also time-consuming, especially given the documentation's lack of clarity. Additionally, the absence of Gradle examples creates further inconvenience, as the available resources are tailored exclusively to Maven users. To make matters worse, the provided quickstart archetypes are still designed for Spring Boot 2.4.0 - a version that was released over five years ago (!), which means they are impractical for modern development needs. I would love to see better docs for the installation and setup process.

programista10kpln avatar Mar 20 '25 20:03 programista10kpln

Thanks for the feedback. I understand that the complexity of the setup might be a small hinderance, but I hope that the documentation at least contains all necessary information. Updating the quickstart archetypes shouldn't be a big deal and help on this is very welcome, but since you mentioned Gradle, do you know if there is an equivalent concept to archetypes in the Gradle world? Surely we can try to add setup variants for Gradle in the docs, it's just that nobody requested it so far :)

beikov avatar Mar 25 '25 08:03 beikov

For me personally documentation is a bit convoluted. I strongly believe that up-to-date examples for spring boot 3.x would help immensely. To my knowledge, there is not an equivalent concept to archetypes in Gradle, sadly.

programista10kpln avatar Apr 21 '25 08:04 programista10kpln

@programista10kpln if you have a good idea on how to provide those up-to-date examples, just go forward and contribute the documentation for that. This would help immensely

EugenMayer avatar Apr 21 '25 14:04 EugenMayer

Unfortunately, I have only managed to make the Core module working for me. I have gave up on the Entity Views, because I could not get them to work, but this issue is not about my personal experience. That's the reason why I am not good candidate for making this kind of contribution. If there will be any highly qualified person to update the docs it will be much appreciated.

programista10kpln avatar Apr 27 '25 12:04 programista10kpln