Getting started fixes

Author: RichardSmedley

modules/devguide/examples/java/SimpleConnect.java

@@ -0,0 +1,20 @@
+// tag::simple-connect[]
+// tag::imports[]
+import com.couchbase.client.java.*;
+// end::imports[]
+
+public class SimpleConnect {
+  static String connectionString = "couchbases://example.com";
+  static String username = "username";
+  static String password = "Password!123";
+  static String bucketName = "travel-sample";
+
+  public static void main(String... args) {
+    // tag::connect-string[]
+    // Alternatively, connect without customizing the cluster envionrment.
+    Cluster cluster = Cluster.connect(connectionString, username, password);
+    // end::connect-string[]
+    cluster.disconnect();
+  }
+}
+// end::simple-connect[]

modules/hello-world/pages/sample-application.adoc

@@ -1,4 +1,5 @@
 = Quickstart in Couchbase with Spring Boot and Java
+:page-toclevels: 2
 :description: Quickstart app to build a REST API using Couchbase Capella in Java using Spring Boot
 :page-aliases: ROOT:sample-application,ROOT:tutorial4,ROOT:sample-app-backend
 
@@ -9,15 +10,13 @@
 Discover how to program interactions with Couchbase via the Data, Query, and Search services.
 
 
-After you have navigated through
-
-[signing up to Capella],
-if {} is entered as your chosen language, you will be pointed to a clonable quickstart app on GitHub.
+After you have navigated through https://cloud.couchbase.com/sign-up[signing up to Capella],
+if {name_platform} is entered as your chosen language, you will be pointed to a clonable quickstart app on GitHub.
 If you were not, you can still find it https://github.com/couchbase-examples/java-springboot-quickstart[here].
 
 
 Often, the first step developers take after creating their database is to create a REST API that can perform Create, Read, Update, and Delete (CRUD) operations for that database.
-The https://github.com/couchbase-examples/java-springboot-quickstart[quickstart repo] is designed to teach you and give you a starter project (in Java using Spring Boot) to generate such a REST API.
+The https://github.com/couchbase-examples/java-springboot-quickstart[quickstart project] is designed to teach you and give you a starter project (in Java using Spring Boot) to generate such a REST API.
 After you have loaded the travel-sample bucket in your database, you can run this application which is a REST API with Swagger documentation so that you can learn:
 
 . How to create, read, update, and delete documents using xref:howto:kv-operations[Key-Value operations].

modules/hello-world/pages/start-using-sdk.adoc

@@ -127,11 +127,12 @@ In production, Couchbase strongly recommends setting up users with more granular
 
 
 == Installation
+
 We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available.
 // Other supported Java versions will work, too.
 Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central].
 
-The latest version of 3.7.x is https://central.sonatype.com/artifact/com.couchbase.client/java-client/{sdk_current_version}/jar[{sdk_current_version}].
+The latest version of {sdk_dot_minor}.x is https://central.sonatype.com/artifact/com.couchbase.client/java-client/{sdk_current_version}/jar[{sdk_current_version}].
 
 // tag::quick-install[]
 More details of the installation process are in the 
@@ -181,7 +182,7 @@ If you're all set up and in a real hurry, just grab this code sample and add in
 [%collapsible]
 ====
 ....
-include::devguide:example$scala/Cloud.scala[]
+include::devguide:example$java/StartUsingCapella.java[]
 ....
 ====
 
@@ -212,7 +213,7 @@ Self-Managed Couchbase Server::
 
 [source,java]
 ----
-include::example$java/StartUsing.java[tags=connect-info,indent=0]
+include::devguide:example$java/StartUsing.java[tags=connect-info,indent=0]
 ----
 --
 
@@ -596,7 +597,7 @@ or the xref:{version-server}@server:manage:manage-settings/install-sample-bucket
 
 [source.try-it,java]
 ----
-include::example$StartUsing.java[tags=start-using,indent=0]
+include:devguide::example$StartUsing.java[tags=start-using,indent=0]
 ----
 --
 ====
@@ -718,7 +719,7 @@ Local Couchbase Server::
 
 [source,java]
 ----
-include::example$StartUsing.java[tags=connect-info,indent=0]
+include::devguide:example$StartUsing.java[tags=connect-info,indent=0]
 ----
 --
 ====
@@ -762,7 +763,7 @@ This example shows how to connect and customize the xref:howtos:managing-connect
 
 [source,java]
 ----
-include::example$StartUsing.java[tags=connect-env,indent=0]
+include::devguide:example$StartUsing.java[tags=connect-env,indent=0]
 ----
 --
 ====