add explore note

MicrosoftLearning · Aug 5, 2022 · 9318e64 · 9318e64
1 parent 48423ed
commit 9318e64
Show file tree

Hide file tree

Showing 8 changed files with 21 additions and 91 deletions.
diff --git a/documentation/00-script.md b/documentation/00-script.md
@@ -38,6 +38,9 @@ By completing this challenge, you'll learn how to:
 - Use functions in your scripts.
 - Use parameters in your scripts.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 30 minutes

diff --git a/documentation/00-set-up.md b/documentation/00-set-up.md
diff --git a/documentation/01-aml-job.md b/documentation/01-aml-job.md
@@ -33,6 +33,9 @@ By completing this challenge, you'll learn how to:
 - Define an Azure Machine Learning job in YAML.
 - Run an Azure Machine Learning job with the CLI v2.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 30 minutes

diff --git a/documentation/02-github-actions.md b/documentation/02-github-actions.md
@@ -35,6 +35,9 @@ By completing this challenge, you'll learn how to:
 - Create a service principal and use it to create a GitHub secret for authentication.
 - Run the Azure Machine Learning job with GitHub Actions.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 45 minutes

diff --git a/documentation/03-trigger-workflow.md b/documentation/03-trigger-workflow.md
@@ -34,6 +34,9 @@ By completing this challenge, you'll learn how to:
 - Protect the main branch.
 - Trigger a GitHub Actions workflow by creating a pull request.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 45 minutes

diff --git a/documentation/04-unit-test-linting.md b/documentation/04-unit-test-linting.md
@@ -35,6 +35,9 @@ By completing this challenge, you'll learn how to:
 - Run linters and unit tests with GitHub Actions.
 - Troubleshoot errors to improve your code.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 45 minutes

diff --git a/documentation/05-environments.md b/documentation/05-environments.md
@@ -40,6 +40,9 @@ By completing this challenge, you'll learn how to:
 - Add a required reviewer.
 - Add environments to a GitHub Actions workflow.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 60 minutes

diff --git a/documentation/06-deploy-model.md b/documentation/06-deploy-model.md
@@ -34,6 +34,9 @@ By completing this challenge, you'll learn how to:
 - Deploy the model to an online endpoint with GitHub Actions.
 - Test the deployed model.
 
+> **Important!**
+> Each challenge is designed to allow you to explore how to implement DevOps principles when working with machine learning models. Some instructions may be intentionally vague, inviting you to think about your own preferred approach. If for example, the instructions ask you to create an Azure Machine Learning workspace, it's up to you to explore and decide how you want to create it. To make it the best learning experience for you, it's up to you to make it as simple or as challenging as you want.
+
 ## Challenge Duration
 
 - **Estimated Time**: 45 minutes