recommendations (#1)

Signed-off-by: André Silva <[email protected]>
Co-authored-by: André Silva <[email protected]>

Author: toddbaert

Workshop.md

@@ -20,7 +20,7 @@ time with each exercise and don't hesitate to experiment!
 
 ## Exercise 1: Basic Feature Flags
 
-**Goal**: Implement your first feature flag and understand the basics
+**Goal**: Implement your first feature flag (without OpenFeature) and understand the basics
 
 ### What You'll Learn
 
@@ -58,6 +58,10 @@ time with each exercise and don't hesitate to experiment!
 
 You should see the statistics header toggle on and off based on your feature flag value.
 
+### Learning Outcomes
+
+- Understand that feature flags are an application development practice that can be implemented basically (but as we'll see, can also become quite powerful and complex).
+
 ---
 
 ## Exercise 2: Introduce OpenFeature
@@ -100,6 +104,10 @@ You should see the statistics header toggle on and off based on your feature fla
 You will have a basic OpenFeature integration that allows you to manage feature flags dynamically. You should
 see the custom provider in action, and the feature flags should be evaluated based on the user context.
 
+### Learning Outcomes
+
+- Understand that OpenFeature can be powered by any underlying "backend", as long as it can resolve feature flag values.
+
 ---
 
 ## Exercise 3: Add flagd provider
@@ -146,6 +154,10 @@ You will have integrated the `flagd` provider into your OpenFeature setup, allow
 dynamically using an external service. You should be able to modify flags in the `flagd.json` file and see the changes
 reflected in real-time without restarting the application.
 
+### Learning Outcomes
+
+- Understand that flagd is an OpenFeature-compatible backend for feature flags
+
 ---
 
 ## Exercise 4: Performance Tuning with Integer Flags
@@ -192,6 +204,10 @@ reflected in real-time without restarting the application.
 
 You'll understand how integer flags can control performance characteristics and see real-time impact on application behavior.
 
+### Learning Outcomes
+- Understand that feature flags can be used to control performance characteristics in real-time
+- Understand that feature flags can have multiple types, including integers, strings, and booleans
+
 ---
 
 ## Exercise 5: Data Source Switching
@@ -236,6 +252,10 @@ You'll understand how integer flags can control performance characteristics and
 
 You'll see how feature flags can safely control major architectural decisions and enable smooth data migrations.
 
+### Learning Outcomes
+- Understand that feature flags can be used to control major architectural decisions, such as data sources
+- Understand that feature flags can be used in combination to create complex feature configurations
+
 ---
 
 ## Exercise 6: A/B Testing Implementation
@@ -252,7 +272,7 @@ You'll see how feature flags can safely control major architectural decisions an
 1. Use the flag `EnableStatsHeader`
 
    - Using the `EnableStatsHeader` flag, implement a simple A/B test
-   - Use the `EvaluationContext` to differentiate between users, making sure to use the `_userId` property
+   - Use the `EvaluationContext` to differentiate between users, making sure to use the `_userId` property as the targetingKey
    - Change the localStorage value for `userId` to simulate different users
    - Observe how the tabs are displayed in the web application
 
@@ -266,6 +286,11 @@ You'll see how feature flags can safely control major architectural decisions an
 
 You will have implemented a basic A/B test using feature flags, allowing you to control which users see different variants of the application.
 
+### Learning Outcomes
+
+- Understand that feature flags can be used for A/B testing, allowing you to experiment with different user experiences
+- Understand that feature flags can be used to control the behavior of the application based on user attributes
+
 ---
 
 ## Exercise 7: Flag Analytics and Monitoring using hooks
@@ -297,6 +322,10 @@ You will have implemented a basic A/B test using feature flags, allowing you to
 
 You will have integrated telemetry for feature flags, allowing you to monitor their usage and performance in the Aspire dashboard.
 
+### Learning Outcomes
+- Understand that feature flags can be monitored and analyzed using hooks
+- Understand that feature flags can be visualized in any OTEL compatible dashboard using telemetry data
+
 ---
 
 ## Extra Exercises: Advanced Targeting
@@ -310,6 +339,10 @@ You will have integrated telemetry for feature flags, allowing you to monitor th
 - Implement custom hooks for feature flag evaluations
 - Use hooks to log flag evaluation behavior (see https://openfeature.dev/docs/reference/concepts/hooks/)
 
+## Extra Exercises: Event Handlers
+
+- Add an event handler to listen to flag changes (see https://openfeature.dev/specification/sections/events)
+
 ---
 
 ## Troubleshooting