diff --git a/src/content/ai/best-practices/prompting.md b/src/content/ai/best-practices/prompting.md
index 11094e8a5e..be47e8255f 100644
--- a/src/content/ai/best-practices/prompting.md
+++ b/src/content/ai/best-practices/prompting.md
@@ -168,7 +168,7 @@ final result = await _clueSolverModel.generateContent(
 
 ### Prompt versioning
 
-arrange prompt files is to use [the Google dotprompt format][dotprompt], which allows you to write `.prompt` files that look like this:
+This simple app keeps the prompt strings in code. This makes them hard to track down and update. For production apps, it’s better to keep your prompts separated from the code, perhaps bundled as Flutter assets. One way to arrange prompt files is to use [the Google dotprompt format][dotprompt], which allows you to write `.prompt` files that look like this:
 
 ```markdown
 ---