Guide for Hibernate-reactive

[fedinskiy]

Description

The hibernate-reactive extension is now in a preview status, but lacks any guides, despite having serious differences from ordinary hibernate. Some kind of "getting started" guide for this would be beneficial, especially since asynchronous I/O is a "killer feature" of Quarkus.

Implementation ideas

This guide can be based on this one[1] but with addition of quarkus-specific things, eg getting EntityManagerFactory through dependency injection and not through Persistence.createEntityManagerFactory.

[1] http://hibernate.org/reactive/documentation/1.0/reference/html_single/

[quarkus-bot]

/cc @DavideD, @Sanne, @gavinking

[DavideD]

Where do we need to add the documentation for the extension?

[geoand]

#17728 adds a guide for Hibernate Reactive Panache

[fedinskiy]

@DavideD I was looking for guide here: https://quarkus.io/guides/, and I assume most people will do the same.

[AlexandreGuidin]

@DavideD I was looking for guide here: https://quarkus.io/guides/, and I assume most people will do the same.

I think that the file docs/src/main/asciidoc/hibernate-reactive-panache.adoc will create a guide in that page

Compare it:
https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/hibernate-orm-panache.adoc
https://quarkus.io/guides/hibernate-orm-panache

You can appreciate the preview:
https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/hibernate-reactive-panache.adoc

[fedinskiy]

@Sanne is there any plans for a guide for Hibernate Reactive without Panache?

[Sanne]

yes sure, but it's still experimental.

[Sanne]

up - it's time to resolve this :)