From 9f0144c04a4ab1eceee9121cbf7cef58bfa4f892 Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Tue, 11 Nov 2025 12:10:41 +0100
Subject: [PATCH] fix(kb/aws): warn about argument cases being inconsistent

---
 knowledge base/cloud computing/aws/README.md           |  7 +++++--
 ...eate clones of an rds instance via step function.ts | 10 +++++++++-
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/knowledge base/cloud computing/aws/README.md b/knowledge base/cloud computing/aws/README.md
index 89905b4..a949d80 100644
--- a/knowledge base/cloud computing/aws/README.md	
+++ b/knowledge base/cloud computing/aws/README.md	
@@ -568,7 +568,7 @@ Refer [What is Step Functions?].
 
 Workflows (A.K.A. _state machines_) for building applications, automating processes, orchestrating microservices, and
 creating pipelines.<br/>
-Can also be long-running and require human interaction.
+Can also be long-running, and require human interaction if correctly configured.
 
 Step Functions call AWS services or external workers to perform tasks.<br/>
 They can also call other Step Functions in various ways (wait for finish, just start, …). See
@@ -585,7 +585,7 @@ In the context of Step Functions:
 
 Workflows can be:
 
-- _Standard_, if they run each step **exactly** once, for long time.<br/>
+- _Standard_, if they run each step **exactly** once, eventually for long time.<br/>
   They can run for up to 1y, are auditable, and show execution history and visual debugging.
 
   Step Functions counts a _state transition_ each time a step in a standard workflow is executed.<br/>
@@ -662,6 +662,9 @@ If wanting to send logs to CloudWatch, the execution role must be able to access
 
 </details>
 
+The casing of arguments is inconsistent and might change from one called resource to another or even inside them.<br/>
+E.g., `arn:aws:states:::aws-sdk:rds:restoreDBInstanceToPointInTime` uses both `SourceDBInstanceIdentifier` (focus on
+`DB`, both letters being uppercase) and `DbInstanceClass` (focus on `Db`, only `D` being uppercase).<br/>
 Unless one knows exactly what one is doing, prefer setting arguments from the service's Console to have _some_ level of
 suggestions.
 
diff --git a/snippets/pulumi/aws/create clones of an rds instance via step function.ts b/snippets/pulumi/aws/create clones of an rds instance via step function.ts
index 4985a73..28191d2 100644
--- a/snippets/pulumi/aws/create clones of an rds instance via step function.ts	
+++ b/snippets/pulumi/aws/create clones of an rds instance via step function.ts	
@@ -29,6 +29,8 @@ type StateMachineBaseState = {
 /**
  * Choice state.\
  * Enables conditional branching.
+ *
+ * Refer <https://docs.aws.amazon.com/step-functions/latest/dg/state-choice.html>.
  */
 interface StateMachineChoiceState extends StateMachineBaseState {
     Type: "Choice";
@@ -47,6 +49,8 @@ type StateMachineParallelBranch = {
 /**
  * Parallel state.\
  * Runs other step states in parallel.
+ *
+ * Refer <https://docs.aws.amazon.com/step-functions/latest/dg/state-parallel.html>.
  */
 interface StateMachineParallelState extends StateMachineBaseState {
     Type: "Parallel";
@@ -56,6 +60,8 @@ interface StateMachineParallelState extends StateMachineBaseState {
 /**
  * Task state.\
  * Runs a service integration or Lambda function.
+ *
+ * Refer <https://docs.aws.amazon.com/step-functions/latest/dg/state-task.html>.
  */
 interface StateMachineTaskState extends StateMachineBaseState {
     Type: "Task";
@@ -67,6 +73,8 @@ interface StateMachineTaskState extends StateMachineBaseState {
 /**
  * Wait state.\
  * Pauses execution for a fixed duration or until a specified time or date.
+ *
+ * Refer <https://docs.aws.amazon.com/step-functions/latest/dg/state-wait.html>.
  */
 interface StateMachineWaitState extends StateMachineBaseState {
     Type: "Wait";
@@ -110,7 +118,7 @@ const checkClonedDbInstanceIsAvailable: StateMachineChoiceState = {
     Type: "Choice",
     Choices: [
         {
-            Condition: "{% $states.input.ClonedDBInstance.DBInstanceStatus in ['available'] %}",
+            Condition: "{% $states.input.ClonedDBInstance.DbInstanceStatus in ['available'] %}",
             Next: "ChangeClonedDBInstancePassword",
         },
     ],