diff --git a/docs/adapter-authoring-guide.md b/docs/adapter-authoring-guide.md
index f57a392..f2b76ca 100644
--- a/docs/adapter-authoring-guide.md
+++ b/docs/adapter-authoring-guide.md
@@ -337,6 +337,8 @@ When a condition is **not met**, the adapter skips the resources phase but still
 
 Resources define the Kubernetes objects your adapter creates on the management cluster. They execute **sequentially** in the order listed — a namespace defined first is available for resources defined after it.
 
+**Important**: Include an annotation `hyperfleet.io/generation: {{ .generation }}` to the kubernetes resources to create. This will be used by adapters to know if the object is in current generation or must be updated.
+
 ### Inline manifests
 
 ```yaml