docs: update readme file docs

Signed-off-by: Otavio Santana <[email protected]>

Author: otaviojava

README.adoc

@@ -1,66 +1,90 @@
-# arangodb-sample
+= arangodb-sample
 
 This project uses Quarkus, the Supersonic Subatomic Java Framework.
 
-If you want to learn more about Quarkus, please visit its website: <https://quarkus.io/>.
+If you want to learn more about Quarkus, please visit its website: https://quarkus.io/.
 
-## Running the application in dev mode
+== Running the application in dev mode
 
 You can run your application in dev mode that enables live coding using:
 
-```shell script
+[source,shell]
+----
 ./mvnw compile quarkus:dev
-```
+----
 
-> **_NOTE:_**  Quarkus now ships with a Dev UI, which is available in dev mode only at <http://localhost:8080/q/dev/>.
+[NOTE]
+====
+Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.
+====
 
-## Packaging and running the application
+== Packaging and running the application
 
 The application can be packaged using:
 
-```shell script
+[source,shell]
+----
 ./mvnw package
-```
+----
 
 It produces the `quarkus-run.jar` file in the `target/quarkus-app/` directory.
 Be aware that it’s not an _über-jar_ as the dependencies are copied into the `target/quarkus-app/lib/` directory.
 
-The application is now runnable using `java -jar target/quarkus-app/quarkus-run.jar`.
+The application is now runnable using:
+
+[source,shell]
+----
+java -jar target/quarkus-app/quarkus-run.jar
+----
 
 If you want to build an _über-jar_, execute the following command:
 
-```shell script
+[source,shell]
+----
 ./mvnw package -Dquarkus.package.jar.type=uber-jar
-```
+----
+
+The application, packaged as an _über-jar_, is now runnable using:
 
-The application, packaged as an _über-jar_, is now runnable using `java -jar target/*-runner.jar`.
+[source,shell]
+----
+java -jar target/*-runner.jar
+----
 
-## Creating a native executable
+== Creating a native executable
 
 You can create a native executable using:
 
-```shell script
+[source,shell]
+----
 ./mvnw package -Dnative
-```
+----
 
 Or, if you don't have GraalVM installed, you can run the native executable build in a container using:
 
-```shell script
+[source,shell]
+----
 ./mvnw package -Dnative -Dquarkus.native.container-build=true
-```
+----
+
+You can then execute your native executable with:
 
-You can then execute your native executable with: `./target/arangodb-sample-1.0.0-SNAPSHOT-runner`
+[source,shell]
+----
+./target/arangodb-sample-1.0.0-SNAPSHOT-runner
+----
 
-If you want to learn more about building native executables, please consult <https://quarkus.io/guides/maven-tooling>.
+If you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.
 
-## Related Guides
+== Related Guides
 
-- REST ([guide](https://quarkus.io/guides/rest)): A Jakarta REST implementation utilizing build time processing and Vert.x. This extension is not compatible with the quarkus-resteasy extension, or any of the extensions that depend on it.
+* REST (https://quarkus.io/guides/rest): A Jakarta REST implementation utilizing build time processing and Vert.x.
+This extension is not compatible with the `quarkus-resteasy` extension, or any of the extensions that depend on it.
 
-## Provided Code
+== Provided Code
 
-### REST
+=== REST
 
-Easily start your REST Web Services
+Easily start your REST Web Services.
 
 [Related guide section...](https://quarkus.io/guides/getting-started-reactive#reactive-jax-rs-resources)