- Documentation for pre-req and node_modules feature

- Gradle wrapper upgrade to 8.7

Signed-off-by: Gopal S Akshintala <[email protected]>

Author: overfullstack

CONTRIBUTING.adoc

@@ -45,7 +45,7 @@ This is a simple Gradle project and has its own Gradle wrapper. So nothing to in
 ./gradlew clean build
 ----
 
-TIP: You *don't* need a local Gradle installation as the `gradlew` (Gradle wrapper) takes care of everything. But if you wish to install gradle locally, the recommendation is to  do it via https://sdkman.io/install[SDKMAN]. After you install SDKMAN, run `sdk install gradle` to install Gradle
+TIP: You *don't* need a local Gradle installation as the `gradlew` (Gradle wrapper) takes care of everything. But if you wish to install Gradle locally, the recommendation is to  do it via https://sdkman.io/install[SDKMAN]. After you install SDKMAN, run `sdk install gradle` to install Gradle
 
 You can run/debug the existing unit tests or write your own to play with the tool.
 

README.adoc

@@ -1,10 +1,3 @@
-####################################################################################################
-#  Copyright (c) 2023, Salesforce, Inc. All rights reserved. SPDX-License-Identifier: 
-#           Apache License Version 2.0 
-#  For full license text, see the LICENSE file in the repo root or
-#  http://www.apache.org/licenses/LICENSE-2.0
-####################################################################################################
-
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

docs/images/failure-hierarchy.png

@@ -1,11 +1,20 @@
 #!/bin/sh
 
-####################################################################################################
-#  Copyright (c) 2023, Salesforce, Inc. All rights reserved. SPDX-License-Identifier: 
-#           Apache License Version 2.0 
-#  For full license text, see the LICENSE file in the repo root or
-#  http://www.apache.org/licenses/LICENSE-2.0
-####################################################################################################
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
 
 ##############################################################################
 #

docs/images/node_modules.png

@@ -43,11 +43,11 @@ set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
 if %ERRORLEVEL% equ 0 goto execute
 
-echo.
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
@@ -57,11 +57,11 @@ set JAVA_EXE=%JAVA_HOME%/bin/java.exe
 
 if exist "%JAVA_EXE%" goto execute
 
-echo.
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 

docs/images/step-execution.png

@@ -76,24 +76,24 @@ void revUpPQ() {
                 .customDynamicVariableGenerator( // <5>
                     "$unitPrice",
                     (ignore1, ignore2, ignore3) -> String.valueOf(Random.Default.nextInt(999) + 1))
-                .nodeModulesResourceRelativePath("js")
+                .nodeModulesResourceRelativePath("js") // <6>
                 .haltOnFailureOfTypeExcept(
                     HTTP_STATUS,
-                    afterAllStepsContainingHeader("ignoreHTTPStatusUnsuccessful")) // <6>
-                .requestConfig( // <7>
+                    afterAllStepsContainingHeader("ignoreHTTPStatusUnsuccessful")) // <7>
+                .requestConfig( // <8>
                     unmarshallRequest(
                         beforeAllStepsWithURIPathEndingWith(PQ_URI_PATH),
                         PlaceQuoteInputRepresentation.class,
                         adapter(PlaceQuoteInputRepresentation.class)))
-                .responseConfig( // <8>
+                .responseConfig( // <9>
                     unmarshallResponse(
                         afterAllStepsWithURIPathEndingWith(PQ_URI_PATH),
                         PlaceQuoteOutputRepresentation.class),
                     unmarshallResponse(
                         afterAllStepsWithURIPathEndingWith(COMPOSITE_GRAPH_URI_PATH),
                         CompositeGraphResponse.class,
                         CompositeGraphResponse.ADAPTER))
-                .hooks( // <9>
+                .hooks( // <10>
                     pre(
                         beforeAllStepsWithURIPathEndingWith(PQ_URI_PATH),
                         (step, requestInfo, rundown) -> {
@@ -104,7 +104,7 @@ void revUpPQ() {
                     post(
                         afterAllStepsWithURIPathEndingWith(PQ_URI_PATH),
                         (stepReport, ignore) -> {
-                          validatePQResponse(stepReport); // <10>
+                          validatePQResponse(stepReport); // <11>
                           final var isSyncStep =
                               stepReport.responseInfo.get().containsHeader(IS_SYNC_HEADER);
                           if (!isSyncStep) {
@@ -122,10 +122,10 @@ void revUpPQ() {
                     post(
                         afterStepName("query-quote-and-related-records"),
                         (ignore, rundown) -> assertAfterPQCreate(rundown.mutableEnv)))
-                .customAdaptersForMarshalling(new IDAdapter()) // <11>
-                .insecureHttp(true) // <12>
+                .customAdaptersForMarshalling(new IDAdapter()) // <12>
+                .insecureHttp(true) // <13>
                 .off()); // Kick-off
-    assertThat(pqRundown.firstUnIgnoredUnsuccessfulStepReport()).isNull(); // <13>
+    assertThat(pqRundown.firstUnIgnoredUnsuccessfulStepReport()).isNull(); // <14>
     assertThat(pqRundown.mutableEnv)
         .containsAtLeastEntriesIn(
             Map.of(