Some additional refinements

Author: gsmet

documentation/modules/ROOT/pages/01_setup.adoc

@@ -69,14 +69,14 @@ Alternatively on Windows you can also try https://chocolatey.org/[Chocolatey] wh
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-  curl -s "https://get.sdkman.io" | bash
-  source "$HOME/.sdkman/bin/sdkman-init.sh"
-.
-  sdk install java
-  sdk install maven
-  sdk install quarkus
-  sdk install java 21.0.3-tem
-  sdk install jbang
+curl -s "https://get.sdkman.io" | bash
+source "$HOME/.sdkman/bin/sdkman-init.sh"
+
+sdk install java
+sdk install maven
+sdk install quarkus
+sdk install java 21.0.3-tem
+sdk install jbang
 ----
 =====
 --

documentation/modules/ROOT/pages/02_basics.adoc

@@ -8,7 +8,7 @@
 ====
 
 Maven::
-+ 
++
 --
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
@@ -20,11 +20,11 @@ cd {project-name}
 Quarkus CLI::
 +
 --
-The quarkus CLI tool lets you create projects, manage extensions and do essential dev, build and deploy commands using the underlying project build tool in a simplified way. 
+The quarkus CLI tool lets you create projects, manage extensions and do essential dev, build and deploy commands using the underlying project build tool in a simplified way.
 
 Follow these instructions to install Quarkus CLI: https://quarkus.io/guides/cli-tooling
 
-Then create the application: 
+Then create the application:
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
@@ -49,7 +49,7 @@ Or else if you're a CLI person, you can run a `curl` command like:
 [.console-input]
 [source,bash]
 ----
-curl localhost:8080/hello
+curl -w '\n' localhost:8080/hello
 ----
 
 [.console-output]
@@ -83,7 +83,7 @@ You can run the test in your IDE or by running the following:
 [tabs%sync]
 ====
 Maven::
-+ 
++
 --
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
@@ -132,7 +132,7 @@ Let's start the _Live Coding_ mode by using the `dev` command. You probably won'
 [tabs%sync]
 ====
 Maven::
-+ 
++
 --
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
@@ -152,7 +152,7 @@ quarkus dev
 --
 ====
 
-NOTE: By default Quarkus uses 'localhost' for the dev mode host setting. If you are working in a remote development environment, you may need to set the host to 0.0.0.0 by appending `-D"quarkus.http.host=0.0.0.0"` to the above command. 
+NOTE: By default Quarkus uses 'localhost' for the dev mode host setting. If you are working in a remote development environment, you may need to set the host to 0.0.0.0 by appending `-D"quarkus.http.host=0.0.0.0"` to the above command.
 
 == Dev UI
 
@@ -182,6 +182,6 @@ Press `r` and the tests will start running. You should see the status change dow
 All 1 test is passing (0 skipped), 1 test was run in 11705ms. Tests completed at 16:02:32.
 ----
 
-TIP: If you don’t want to have continuous testing enabled, you can change this by adding `quarkus.test.continuous-testing=disabled` to your `src/main/resources/application.properties`. 
+TIP: If you don’t want to have continuous testing enabled, you can change this by adding `quarkus.test.continuous-testing=disabled` to your `src/main/resources/application.properties`.
 
-You can find more details about controlling continuous testing in https://quarkus.io/guides/continuous-testing#controlling-continuous-testing[this guide]. 
+You can find more details about controlling continuous testing in https://quarkus.io/guides/continuous-testing#controlling-continuous-testing[this guide].

documentation/modules/ROOT/pages/03_configuration.adoc

@@ -1,6 +1,6 @@
 = Configuration
 
-Hardcoded values in your code is a no go, so let's see how to add configuration to your application. 
+Hardcoded values in your code is a no go, so let's see how to add configuration to your application.
 Quarkus relies on the MicroProfile Config specification and the main configuration file is  `application.properties`.
 
 == Using a config property in your code
@@ -38,23 +38,17 @@ If you refresh your browser pointing to http://localhost:8080/hello[window="_bla
 [.console-output]
 [source,text]
 ----
-jakarta.enterprise.inject.spi.DeploymentException: No config value of type [java.lang.String] exists for: greeting
-	at io.quarkus.arc.runtime.ConfigRecorder.validateConfigProperties(ConfigRecorder.java:37)
-	at io.quarkus.deployment.steps.ConfigBuildStep$validateConfigProperties61.deploy_0(ConfigBuildStep$validateConfigProperties61.zig:120)
-	at io.quarkus.deployment.steps.ConfigBuildStep$validateConfigProperties61.deploy(ConfigBuildStep$validateConfigProperties61.zig:36)
-	at io.quarkus.runner.ApplicationImpl.doStart(ApplicationImpl.zig:166)
-	at io.quarkus.runtime.Application.start(Application.java:89)
-	at io.quarkus.runtime.ApplicationLifecycleManager.run(ApplicationLifecycleManager.java:90)
-	at io.quarkus.runtime.Quarkus.run(Quarkus.java:61)
-	at io.quarkus.runtime.Quarkus.run(Quarkus.java:38)
-	at io.quarkus.runtime.Quarkus.run(Quarkus.java:106)
-	at io.quarkus.runner.GeneratedMain.main(GeneratedMain.zig:29)
-	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
-	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
-	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
-	at java.base/java.lang.reflect.Method.invoke(Method.java:566)
-	at io.quarkus.runner.bootstrap.StartupActionImpl$1.run(StartupActionImpl.java:99)
-	at java.base/java.lang.Thread.run(Thread.java:834)
+io.quarkus.runtime.configuration.ConfigurationException: Failed to load config value of type class java.lang.String for: greeting
+	at io.quarkus.arc.runtime.ConfigRecorder.validateConfigProperties(ConfigRecorder.java:70)
+	at io.quarkus.deployment.steps.ConfigBuildStep$validateConfigValues1665125174.deploy_0(Unknown Source)
+	at io.quarkus.deployment.steps.ConfigBuildStep$validateConfigValues1665125174.deploy(Unknown Source)
+	at io.quarkus.runner.ApplicationImpl.doStart(Unknown Source)
+	at io.quarkus.runtime.Application.start(Application.java:101)
+	at io.quarkus.runtime.ApplicationLifecycleManager.run(ApplicationLifecycleManager.java:111)
+	at io.quarkus.runtime.Quarkus.run(Quarkus.java:71)
+	at io.quarkus.runtime.Quarkus.run(Quarkus.java:44)
+	at io.quarkus.runtime.Quarkus.run(Quarkus.java:124)
+	at io.quarkus.runner.GeneratedMain.main(Unknown Source)
 ----
 
 Which is expected, since we didn't provide the `greeting` property neither at the `application.properties` file nor with some runtime configuration.
@@ -78,7 +72,7 @@ You can also use `curl` to check the same result:
 [.console-input]
 [source,bash]
 ----
-curl localhost:8080/hello
+curl -w '\n' localhost:8080/hello
 ----
 
 [.console-output]
@@ -87,9 +81,9 @@ curl localhost:8080/hello
 Hello y'all!
 ----
 
-== Update your integration test
+== Update your test
 
-Since we changed the output of our `/hello` endpoint, our integration test doesn't pass anymore.
+Since we changed the output of our `/hello` endpoint, our test doesn't pass anymore.
 
 Let's update `GreetingResourceTest` to reflect our recent changes:
 
@@ -136,7 +130,7 @@ Now run your tests to check if everything is ok:
 [tabs]
 ====
 Maven::
-+ 
++
 --
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
@@ -177,7 +171,7 @@ quarkus test
 [tabs]
 ====
 Maven::
-+ 
++
 --
 [.console-input]
 [source,bash,subs="+macros,+attributes"]

documentation/modules/ROOT/pages/06_dev-services.adoc

@@ -25,6 +25,7 @@ TIP: You technically don't need to add the `db-kind` property since there is onl
 greeting=Hello y'all!
 quarkus.datasource.db-kind=postgresql
 quarkus.hibernate-orm.database.generation=drop-and-create
+quarkus.hibernate-orm.sql-load-script=import.sql
 ----
 
 WARNING: Make sure the h2 `db-kind` and `jdbc.url` properties have been removed.
@@ -39,8 +40,8 @@ Maven::
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-./mvnw quarkus:remove-extension -Dextension=quarkus-jdbc-h2
 ./mvnw quarkus:add-extension -Dextension=quarkus-jdbc-postgresql
+./mvnw quarkus:remove-extension -Dextension=quarkus-jdbc-h2
 ----
 
 --
@@ -50,8 +51,8 @@ Quarkus CLI::
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-quarkus extension remove quarkus-jdbc-h2
 quarkus extension add quarkus-jdbc-postgresql
+quarkus extension remove quarkus-jdbc-h2
 ----
 --
 ====
@@ -62,12 +63,12 @@ Notice in the logs how Quarkus has reloaded and started up a PostgreSQL database
 [.console-output]
 [source,text]
 ----
-2023-03-16 08:06:56,882 INFO  [io.qua.dat.dep.dev.DevServicesDatasourceProcessor] (build-13) Dev Services for the default datasource (postgresql) started - container ID is c7c9a6ccf029
+2024-05-23 17:46:51,225 INFO  [io.qua.dat.dep.dev.DevServicesDatasourceProcessor] (build-32) Dev Services for default datasource (postgresql) started - container ID is b2957fbe64ee
 ----
 
-== Verify Postgresql testcontainer is running
+== Verify PostgreSQL container is running
 
-Let's verify in Docker/Podman that the Dev Services container is running.  You should see 2 containers, one testcontainers/ryuk container which orchestrates the Dev Services, and another PostgreSQL container which is running the database and which is automatically wired into our Quarkus dev mode:
+Let's verify in Docker/Podman that the Dev Services container is running.  You should see 2 containers, one `testcontainers/ryuk` container which orchestrates the Dev Services, and another `postgres` container which is running the database and which is automatically wired into our Quarkus dev mode:
 
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
@@ -83,7 +84,7 @@ Call the fruit endpoint again. The data is now coming from the PostgreSQL databa
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-curl localhost:8080/fruit?season=Spring
+curl -w '\n' localhost:8080/fruit?season=Spring
 ----
 
 [.console-output]

documentation/modules/ROOT/pages/07_spring.adoc

@@ -14,7 +14,6 @@ Maven::
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-./mvnw quarkus:remove-extension -D"extensions=rest"
 ./mvnw quarkus:add-extension -D"extensions=spring-web,spring-data-jpa"
 ----
 
@@ -25,7 +24,6 @@ Quarkus CLI::
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-quarkus ext remove rest
 quarkus ext add spring-web spring-data-jpa
 ----
 --
@@ -40,14 +38,14 @@ quarkus ext add spring-web spring-data-jpa
 [INFO] Building tutorial-app 1.0-SNAPSHOT
 [INFO] --------------------------------[ jar ]---------------------------------
 [INFO]
-[INFO] --- quarkus-maven-plugin:1.4.2.Final:add-extension (default-cli) @ tutorial-app ---
+[INFO] --- quarkus-maven-plugin:3.10.2:add-extension (default-cli) @ tutorial-app ---
 ✅ Adding extension io.quarkus:quarkus-spring-data-jpa
 ✅ Adding extension io.quarkus:quarkus-spring-web
 [INFO] ------------------------------------------------------------------------
 [INFO] BUILD SUCCESS
 [INFO] ------------------------------------------------------------------------
 [INFO] Total time:  2.052 s
-[INFO] Finished at: 2020-05-11T21:33:15-04:00
+[INFO] Finished at: 2024-05-23T21:33:15-04:00
 [INFO] ------------------------------------------------------------------------
 ----
 
@@ -115,7 +113,7 @@ Let's try to filter only the fruits with the *Summer* season.  Don't forget to s
 [.console-input]
 [source,bash]
 ----
-curl localhost:8080/spring-fruit?season=Summer
+curl -w '\n' localhost:8080/spring-fruit?season=Summer
 ----
 
 [.console-output]

documentation/modules/ROOT/pages/08_rest-client.adoc

@@ -62,13 +62,13 @@ quarkus extension add rest-client-jackson
 [INFO] Building tutorial-app 1.0-SNAPSHOT
 [INFO] --------------------------------[ jar ]---------------------------------
 [INFO]
-[INFO] --- quarkus-maven-plugin:1.4.2.Final:add-extension (default-cli) @ tutorial-app ---
+[INFO] --- quarkus-maven-plugin:3.10.2:add-extension (default-cli) @ tutorial-app ---
 ✅ Adding extension io.quarkus:quarkus-rest-client-jackson
 [INFO] ------------------------------------------------------------------------
 [INFO] BUILD SUCCESS
 [INFO] ------------------------------------------------------------------------
 [INFO] Total time:  1.773 s
-[INFO] Finished at: 2020-05-11T21:43:38-04:00
+[INFO] Finished at: 2024-05-23T21:43:38-04:00
 [INFO] ------------------------------------------------------------------------
 ----
 
@@ -253,8 +253,6 @@ import jakarta.ws.rs.core.Response.Status;
 @Path("/fruit")
 public class FruitResource {
 
-
-
     @RestClient
     @Inject
     FruityViceService fruityViceService;
@@ -269,7 +267,6 @@ public class FruitResource {
         return Response.status(Status.CREATED).entity(fruit).build();
     }
 
-
     @GET
     @Produces(MediaType.APPLICATION_JSON)
     public List<FruitDTO> fruits(@QueryParam("season") String season) {

documentation/modules/ROOT/pages/_partials/compile-and-run.adoc

@@ -16,7 +16,7 @@ a|
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
- ./mvnw package 
+ ./mvnw package
 ----
 
 a|
@@ -44,9 +44,9 @@ Native mode::
 +
 --
 
-Quarkus simplifies the https://quarkus.io/guides/building-native-image[compilation of Java applications down to a native binary] using GraalVM/Mandrel. To do so, add a "native" flag to your build command.   
+Quarkus simplifies the https://quarkus.io/guides/building-native-image[compilation of Java applications down to a native binary] using GraalVM/Mandrel. To do so, add a "native" flag to your build command.
 
-NOTE: To force building a native binary in a GraalVM Mandrel container, add `-Dquarkus.native.container-build=true`.  
+NOTE: To force building a native binary in a GraalVM Mandrel container, add `-Dquarkus.native.container-build=true`.
 
 [%header,cols="1,1"]
 |=====
@@ -108,7 +108,7 @@ a|
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-quarkus image build --native 
+quarkus image build --native
 ----
 |=====
 
@@ -132,11 +132,11 @@ You'll see an output like this one:
 [.console-output]
 [source,text]
 ----
-__  ____  __  _____   ___  __ ____  ______ 
- --/ __ \/ / / / _ | / _ \/ //_/ / / / __/ 
- -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \   
---\___\_\____/_/ |_/_/|_/_/|_|\____/___/   
-2023-07-07 11:47:14,046 INFO  [io.quarkus] (main) code-with-quarkus 1.0.0-SNAPSHOT native (powered by Quarkus 3.2.0.Final) started in 0.019s. Listening on: http://0.0.0.0:8080
-2023-07-07 11:47:14,047 INFO  [io.quarkus] (main) Profile prod activated. 
+__  ____  __  _____   ___  __ ____  ______
+ --/ __ \/ / / / _ | / _ \/ //_/ / / / __/
+ -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
+--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
+2023-07-07 11:47:14,046 INFO  [io.quarkus] (main) code-with-quarkus 1.0.0-SNAPSHOT native (powered by Quarkus 3.10.2) started in 0.019s. Listening on: http://0.0.0.0:8080
+2023-07-07 11:47:14,047 INFO  [io.quarkus] (main) Profile prod activated.
 2023-07-07 11:47:14,047 INFO  [io.quarkus] (main) Installed features: [cdi, -reactive, smallrye-context-propagation, vertx]
 ----