diff --git a/modules/ORB/System/Recipe.pm b/modules/ORB/System/Recipe.pm
index 75e3ce6..625c71c 100644
--- a/modules/ORB/System/Recipe.pm
+++ b/modules/ORB/System/Recipe.pm
@@ -105,6 +105,8 @@ sub clear {
 # Create a new recipe in the system. The args hash can contain the following,
 # all fields are required unless indicated otherwise:
 #
+# -          `id`: (optional, avoid) Set the ID to create the recipe with.
+#                  This should generally not be specified unless doing edits.
 # -      `previd`: (optional) ID of the recipe this is an edit of. If specified,
 #                  the old recipe has its state set to 'edited', and the
 #                  metadata context of the new recipe is created as a child of