more improvments

steps/configure_url_api.yml

@@ -10,11 +10,11 @@ startFlow:
       params:
         person: lucca
         messages:
-          - text: It's fine-tuning time!
-          - text: Visit app settings on Autodesk Platform Services.
-          - text: Set the Callback URL to (your app url)/api/auth/callback.
-          - text: Enable all necessary APIs for optimal functionality.
-          - text: Save your configurations to sync changes.
+          - text: It's fine-tuning time! We will configure URLs and enable the required APIs for your app.
+          - text: Visit app settings on Autodesk Platform Services. Navigate to the settings section where you can manage your app configurations.
+          - text: Set the Callback URL to (your app url)/api/auth/callback. This URL will be used for OAuth authentication callbacks.
+          - text: Enable all necessary APIs for optimal functionality. Review the APIs your app needs and enable them in the settings.
+          - text: Save your configurations to sync changes. Ensure all changes are saved to apply the new settings.
     - actionId: ready_message
       params:
         person: lucca

steps/create_aps_account.yml

@@ -10,11 +10,11 @@ startFlow:
       params:
         person: lucca
         messages:
-          - text: Let's set up your Autodesk account.
-          - text: Visit [Autodesk Platform Services](https://aps.autodesk.com).
-          - text: Click 'Sign Up'—quick and easy.
-          - text: Ensure email confirmation to activate your account.
-          - text: Once ready, we move to your next adventure.
+          - text: Let's set up your Autodesk account. This account will give you access to Autodesk Platform Services.
+          - text: Visit [Autodesk Platform Services](https://aps.autodesk.com). This is the official site where you can manage your Autodesk services.
+          - text: Click 'Sign Up'—quick and easy. Fill in the required information such as your name, email, and password.
+          - text: Ensure email confirmation to activate your account. Check your email for a confirmation link and click it to activate your account.
+          - text: Once ready, we move to your next adventure. With your account set up, you can now explore and integrate Autodesk services.
     - actionId: ready_message
       params:
         person: lucca

steps/execute_validate_bim360.yml

@@ -10,11 +10,11 @@ startFlow:
       params:
         person: lucca
         messages:
-          - text: Time to make magic happen.
-          - text: Log into your Autodesk application.
-          - text: Upload an RVT file into a monitored BIM 360 folder.
-          - text: System will detect the upload and trigger workflows.
-          - text: Verify issues in BIM 360 UI.
+          - text: Time to make magic happen. We will now execute and validate BIM 360 workflows.
+          - text: Log into your Autodesk application. Ensure you have the necessary permissions to access BIM 360.
+          - text: Upload an RVT file into a monitored BIM 360 folder. This will trigger the automated workflows configured for the folder.
+          - text: System will detect the upload and trigger workflows. These workflows may include file validation, issue detection, and more.
+          - text: Verify issues in BIM 360 UI. Check the BIM 360 interface for any issues or notifications related to the uploaded file.
     - actionId: ready_message
       params:
         person: lucca

steps/generate_app_credentials.yml

@@ -11,11 +11,11 @@ startFlow:
       params:
         person: lucca
         messages:
-          - text: Time to authenticate your app.
-          - text: Log into Autodesk and navigate to 'Apps & Keys'.
-          - text: "Here lies digital magic: create your app."
-          - text: Receive your Client ID and Secret—protect them well!
-          - text: You're now ready for your app integration.
+          - text: Time to authenticate your app. This is a crucial step to ensure secure communication between your app and Autodesk services.
+          - text: Log into Autodesk and navigate to 'Apps & Keys'. This section allows you to manage your app credentials.
+          - text: "Here lies digital magic: create your app. Fill in the required details such as app name, description, and platform."
+          - text: Receive your Client ID and Secret—protect them well! These credentials are essential for API access and should be stored securely.
+          - text: You're now ready for your app integration. Use these credentials to authenticate API requests and start building your integration.
     - actionId: ready_message
       params:
         person: lucca

steps/motivation_autodesk_integration.yml

@@ -14,17 +14,19 @@ startFlow:
       params:
         file: ${docker-compose.yml}
         path: "."
+    - actionId: github_commit_file
+      params:
+        file: ${devcontainer.json}
+        path: ".devcontainer"
     - actionId: bot_message
       params:
         person: lucca
         messages:
-          - text: Welcome to this Autodesk adventure!
-          - text: "Picture this: seamless data flow between your design tools."
-          - text: Reduce manual work and potential errors—yes, please!
-          - text: By understanding OAuth and Webhooks, automate workflows.
-          - text: Increase team productivity and tackle large projects with ease.
-          - text: Let's dive in and sharpen your tech skills.
-          - text: For more motivation, check [here](https://aps.autodesk.com/success/).
+          - text: Welcome to this Autodesk adventure! We're excited to have you on board as we explore the powerful integration capabilities of Autodesk's suite of tools.
+          - text: "Picture this: seamless data flow between your design tools, enabling you to work more efficiently and effectively without the hassle of manual data transfers. By automating repetitive tasks, you can reduce manual work and potential errors, allowing you to focus on creating innovative designs and solutions."
+          - text: By understanding OAuth and Webhooks, you can automate workflows and securely connect different applications, streamlining your processes. This will increase team productivity and help you tackle large projects with ease.
+          - text: With integrated tools, your team can collaborate more effectively, share information effortlessly, and manage projects more efficiently. This journey will equip you with the knowledge and skills needed to leverage Autodesk integrations to their fullest potential.
+          - text: For more motivation, check [here](https://aps.autodesk.com/). Discover success stories, best practices, and additional resources to keep you inspired and informed.
     - actionId: ready_message
       params:
         person: lucca

steps/run_configure_codespace.yml

@@ -10,11 +10,12 @@ startFlow:
       params:
         person: lucca
         messages:
-          - text: Bring your creation to life in Codespace!
-          - text: Navigate to the root directory.
-          - text: Open `docker-compose.yml` file in your project.
-          - text: "Edit the environmental variables: CLIENT_ID and CLIENT_SECRET."
-          - text: Launch your app and witness its wonders!
+          - text: Bring your creation to life in Codespace! This is where your project starts to take shape.
+          - text: Navigate to the root directory of your project where all the main files are located.
+          - text: Open the `docker-compose.yml` file in your project. This file contains the configuration for your Docker containers.
+          - text: "Edit the environmental variables: CLIENT_ID and CLIENT_SECRET. These variables are crucial for the authentication and authorization of your app."
+          - text: Save the changes you made to the `docker-compose.yml` file to ensure the new configurations are applied.
+          - text: Launch your app using the appropriate command, such as `docker-compose up`, and witness its wonders! Your app should now be running with the updated configurations.
     - actionId: ready_message
       params:
         person: lucca

tests/devcontainer.json

@@ -0,0 +1,8 @@
+{
+  "customizations": {
+    "vscode": {
+      "extensions": ["ms-dotnettools.csdevkit"]
+    }
+  },
+  "forwardPorts": [5000]
+}