text changes

steps/capella_signup_process.yml

@@ -9,13 +9,8 @@ startFlow:
         person: lucca
         messages:
           - text: Now that you're aware of what Capella can do, let's create an account.
-          - text: To sign up, visit [Couchbase Capella
-              Sign-Up](https://cloud.couchbase.com/signup).
-          - text: You'll need to provide some basic details to create your free account
-              quickly.
-          - text: Having an account is the first step in connecting to Capella's features.
-          - text: These features assist in deploying efficient modern applications.
-          - text: Once signed up, let me know, and we can proceed.
+          - text: To sign up, visit [Couchbase Capella Sign-Up](https://cloud.couchbase.com/sign-in). You'll need to provide some basic details to create your free account quickly.
+          - text: Having an account is the first step in connecting to Capella's features. These features assist in deploying efficient modern applications. Once signed up, let me know, and we can proceed.
     - actionId: ready_message
       params:
         person: lucca

steps/create_a_bucket.yml

@@ -9,11 +9,8 @@ startFlow:
         person: lucca
         messages:
           - text: Let's dive into creating buckets—our next ninja move.
-          - text: Buckets in Couchbase are the containers for your data.
-          - text: From inside your cluster dashboard, click '+ Create'.
-          - text: Define your bucket's options, then hit 'Create'.
-          - text: Buckets ensure your data is organized and manageable.
-          - text: Feeling organized already? Proceed when ready.
+          - text: "[Buckets in Couchbase](https://docs.couchbase.com/server/current/learn/buckets-memory-and-storage/buckets.html) are the containers for your data. From inside your cluster dashboard, click '+ Create'."
+          - text: Define your bucket's options, then hit 'Create'. Buckets ensure your data is organized and manageable. Feeling organized already?
     - actionId: ready_message
       params:
         person: lucca

steps/create_couchbase_cluster.yml

@@ -9,12 +9,8 @@ startFlow:
         person: lucca
         messages:
           - text: Excited to set things up? Let's build a Couchbase cluster.
-          - text: Clusters are essential for housing all your Couchbase projects.
-          - text: On the dashboard, find and click 'Create Cluster'.
-          - text: Choose a cloud provider, name your cluster, and select a region.
-          - text: Click 'Create Cluster'. You've leveled up your database management skills!
-          - text: Clusters make handling large data sets a breeze.
-          - text: When your cluster is active, hit that button for the next step.
+          - text: "[Clusters](https://docs.couchbase.com/server/current/learn/clusters-and-availability/clusters-and-availability.html) are essential for housing all your Couchbase projects. On the dashboard, find and click 'Create Cluster'."
+          - text: Choose a cloud provider, name your cluster, and select a region. Click 'Create Cluster'. You've leveled up your database management skills! Clusters make handling large data sets a breeze. When your cluster is active, hit that button for the next step.
     - actionId: ready_message
       params:
         person: lucca

steps/create_vector_search_index.yml

@@ -1,19 +1,15 @@
 id: create_vector_search_index
 learningObjectives:
-  - Explore how to create a vector search index.
 hints: []
 startFlow:
   do:
     - actionId: bot_message
       params:
         person: lucca
         messages:
-          - text: Let's get serious about indexing. We'll create a vector search index.
-          - text: Indexing is crucial for executing similarity searches efficiently.
-          - text: Use Couchbase Shell to create the index with `vector create-index`.
-          - text: Provide bucket name and specified metrics for dot-product similarity.
-          - text: Indexing prepares data for swift, precise querying.
-          - text: When your index is ready, signal for the next step.
+          - text: Let's get serious about indexing. We'll create a [vector search index](https://docs.couchbase.com/server/current/vector-search/vector-search.html).
+          - text: Indexing is crucial for executing similarity searches efficiently. Use Couchbase Shell to create the index with `vector create-index`.
+          - text: Provide bucket name and specified metrics for dot-product similarity. Indexing prepares data for swift, precise querying. When your index is ready, signal for the next step.
     - actionId: ready_message
       params:
         person: lucca

steps/generate_embeddings_steps.yml

@@ -9,11 +9,8 @@ startFlow:
         person: lucca
         messages:
           - text: Embeddings make your searches smarter by enriching data context.
-          - text: Use the `/embed` endpoint with an OpenAI API key for dynamic embeddings.
-          - text: Alternatively, import data with pre-generated embeddings directly.
-          - text: You'll set the `USE_LOCAL_EMBEDDING` flag based on your choice.
-          - text: Make sure your `.env` file is updated for API if going that route.
-          - text: Let's nail those data embeddings! Ready to move forward?
+          - text: Use the `/embed` endpoint with an OpenAI API key for dynamic embeddings. Alternatively, import data with pre-generated embeddings directly.
+          - text: You'll set the `USE_LOCAL_EMBEDDING` flag based on your choice. Make sure your `.env` file is updated for API if going that route. Let's nail those data embeddings! Ready to move forward?
     - actionId: ready_message
       params:
         person: lucca

steps/import_pre_generated_embeddings.yml

@@ -1,21 +1,15 @@
 id: import_pre_generated_embeddings
 learningObjectives:
-  - Know how to import data with pre-generated embeddings.
 hints: []
 startFlow:
   do:
     - actionId: bot_message
       params:
         person: lucca
         messages:
-          - text: Time to import data with embeddings. It's like importing your childhood
-              photo album.
-          - text: Pre-generated embeddings offer a quick start for your searches.
-          - text: Jump into the `individual_items_with_embedding` directory.
-          - text: Edit `./config_file/config` with your Couchbase Capella details.
-          - text: Use Couchbase Shell to bring your data directly into the bucket.
-          - text: Adjustments in the shell ensure you're communicating with your cluster.
-          - text: Signal when you're done importing so we can proceed.
+          - text: Time to import data with embeddings. It's like importing your childhood photo album.
+          - text: "[Pre-generated embeddings](https://www.couchbase.com/blog/what-are-vector-embeddings/) offer a quick start for your searches. Jump into the `individual_items_with_embedding` directory."
+          - text: Edit `./config_file/config` with your Couchbase Capella details. Use Couchbase Shell to bring your data directly into the bucket. Adjustments in the shell ensure you're communicating with your cluster. Signal when you're done importing so we can proceed.
     - actionId: ready_message
       params:
         person: lucca

steps/intro_to_couchbase_capella.yml

@@ -8,14 +8,9 @@ startFlow:
       params:
         person: lucca
         messages:
-          - text: Hello, and welcome! I'm Lucca, your guide through Couchbase Capella.
-          - text: Capella is a fully managed DB service, perfect for modern app building.
-          - text: It offers features that help seamlessly manage and deploy your databases.
-          - text: With Capella, you can focus on building rather than managing
-              infrastructure.
-          - text: Learning how to use Capella is crucial for scalability and efficient app
-              development.
-          - text: When you're ready to dive deeper, click to continue.
+          - text: "Hello, and welcome! I'm Lucca, your guide through [Couchbase Capella](https://www.couchbase.com/products/capella/)."
+          - text: Capella is a fully managed DB service, perfect for modern app building. It offers features that help seamlessly manage and deploy your databases.
+          - text: With Capella, you can focus on building rather than managing infrastructure. Learning how to use Capella is crucial for scalability and efficient app development. When you're ready to dive deeper, click to continue.
     - actionId: ready_message
       params:
         person: lucca

steps/open_question_indexing_challenges.yml

@@ -83,12 +83,7 @@ trigger:
             params:
               person: lucca
               messages:
-                - text: ${outputs.user_answer.value.reply}
-          - actionId: bot_message
-            params:
-              person: lucca
-              messages:
-                - text: Great job wrapping up the Couchbase Capella onboarding!
+                - text: ${outputs.user_answer.value.reply} Great job wrapping up the Couchbase Capella onboarding! For more information, visit the [documentation](https://example.com).
           - actionId: finish_step
       else:
         do:

steps/quiz_data_transformation.yml

@@ -10,8 +10,7 @@ startFlow:
         person: lucca
         messages:
           - text: Pop quiz time! Which method uses dynamic data transformation?
-          - text: "Your options are simple, just like your choice of beverage: static or
-              dynamic?"
+          - text: "Your options are simple, just like your choice of beverage: static or dynamic?"
     - actionId: quiz_message
       name: quiz
       params:
@@ -32,8 +31,7 @@ trigger:
               params:
                 person: lucca
                 messages:
-                  - text: Almost! Pre-generated means using static embeddings without transformation
-                      at the API level. Try again!
+                  - text: Almost! Pre-generated means using static embeddings without transformation at the API level. Try again!
             - actionId: replay_action
               params:
                 actionName: quiz
@@ -43,17 +41,15 @@ trigger:
               params:
                 person: lucca
                 messages:
-                  - text: Bingo! Using the `/embed` endpoint requires real-time transformation with
-                      an API key.
+                  - text: Bingo! Using the `/embed` endpoint requires real-time transformation with an API key. For more details, check out the [documentation](https://example.com).
             - actionId: finish_step
         C:
           do:
             - actionId: bot_message
               params:
                 person: lucca
                 messages:
-                  - text: Not exactly, one of them clearly involves pre-existing data
-                      transformation.
+                  - text: Not exactly, one of them clearly involves pre-existing data transformation. Try again!
             - actionId: replay_action
               params:
                 actionName: quiz

steps/quiz_index_creation.yml

@@ -10,6 +10,7 @@ startFlow:
         person: lucca
         messages:
           - text: How well do you know indexing now? What command creates a vector index?
+          - text: Think about the specific keyword used in the command.
     - actionId: quiz_message
       name: quiz
       params:
@@ -30,15 +31,15 @@ trigger:
               params:
                 person: lucca
                 messages:
-                  - text: Yes! You've got the command syntax memorized.
+                  - text: Yes! You've got the command syntax memorized. Great job!
             - actionId: finish_step
         B:
           do:
             - actionId: bot_message
               params:
                 person: lucca
                 messages:
-                  - text: Ah, close but not quite. It's not related to cluster creation.
+                  - text: Ah, close but not quite. It's not related to cluster creation. Try again!
             - actionId: replay_action
               params:
                 actionName: quiz
@@ -48,7 +49,7 @@ trigger:
               params:
                 person: lucca
                 messages:
-                  - text: Oops, not the right phrase. Think about vector-specific operations.
+                  - text: Oops, not the right phrase. Think about vector-specific operations. Give it another shot!
             - actionId: replay_action
               params:
                 actionName: quiz