rivet-dev · MasterPtato · Jan 16, 2026
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
diff --git a/docs/engine/GASOLINE/GOTCHAS.md b/docs/engine/GASOLINE/GOTCHAS.md
@@ -1,3 +1,11 @@
 # Gotchas
 
-TODO
+## Signal tags
+
+Internally, it is more efficient to order signal tags in a manner of most unique to least unique:
+
+- Given a workflow with tags:
+	- namespace = foo
+	- type = normal
+
+The signal should be published with `namespace = foo` first, then `type = normal`
diff --git a/docs/engine/GASOLINE/WORKFLOW_HISTORY.md b/docs/engine/GASOLINE/WORKFLOW_HISTORY.md
@@ -68,7 +68,7 @@ If we want this workflow to remain the same but new workflows to execute a diffe
 // Activity foo
 ctx.activity(...).await?;
 
-match ctx.check_version(2).await {
+match ctx.check_version(2).await? {
 	// The existing workflow will always match this path because the next event (activity bar) has version 1
 	1 => {
 		// Here we need to keep the workflow steps as expected by the history, run activity bar
@@ -81,7 +81,7 @@ match ctx.check_version(2).await {
 	}
 }
 
-ctx.sleep().await
+ctx.sleep().await?;
 ```
 
 Version checks are durable because if history already exists at the location they are added then they do not manipulate the database and read the version of that history event. But if the version check is at the end of the current branch of events (as in a new workflow), it will be inserted as an event itself. This means the workflow history for both workflows will look like this: