From eda96085937539e28c654d4e41a06eac83ba9400 Mon Sep 17 00:00:00 2001
From: Allison Beemer <66966224+anbeemer@users.noreply.github.com>
Date: Tue, 16 Jul 2024 09:58:55 -0500
Subject: [PATCH] Added note about replacement order

---
 docs/tutorials/text_replacements.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/tutorials/text_replacements.rst b/docs/tutorials/text_replacements.rst
index dab0155..e670aa3 100644
--- a/docs/tutorials/text_replacements.rst
+++ b/docs/tutorials/text_replacements.rst
@@ -25,6 +25,8 @@ Note that `_course_metadata/replacements.json` is just a regular old JSON file.
 Usage
 --------
 
+Keep in mind that the order of replacement is unspecified. Thus, it is important to choose keys that will not appear within values, and will not appear within source documents where replacement is undesired.
+
 
 Custom text replacements per-content
 --------------------------------------