From 3f25bb8bc954bb7ec524fcedf5919cd27055388f Mon Sep 17 00:00:00 2001
From: Simon Willison <swillison@gmail.com>
Date: Sun, 13 Apr 2025 20:49:55 -0700
Subject: [PATCH] Document difference between templates and fragments, cloess
 #918

!stable-docs
---
 docs/templates.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/templates.md b/docs/templates.md
index d40dbaf..e03c959 100644
--- a/docs/templates.md
+++ b/docs/templates.md
@@ -1,11 +1,13 @@
 (prompt-templates)=
 # Templates
 
-Templates can be created for prompts to make them reusable and shareable.
+A **template** can combine a prompt, system prompt, model, default model options, schema, and fragments into a single reusable unit.
+
+Only one template can be used at a time. To compose multiple shorter pieces of prompts together consider using {ref}`fragments <fragments>` instead.
 
 (prompt-templates-save)=
 
-## Getting started with --save
+## Getting started with <code>--save</code>
 
 The easiest way to create a template is using the `--save template_name` option.