diff --git a/README.md b/README.md
index 4aaa4f3..1ce4fdf 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,14 @@
 
 This repo exists to make it easy to [call chezmoi](https://www.chezmoi.io/reference/commands/init/).
 
+<!-- markdownlint-disable MD013 -->
+
+> [!CAUTION]
+> this repo location (`$GITHUB_TRIGGERING_ACTOR/dotfiles`) is a hardcoded external requirement for chezmoi and [helpful for github](https://docs.github.com/en/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#dotfiles).
+
+<!-- `chezmoi init --apply "${GITHUB_TRIGGERING_ACTOR}` -->
+
+<!-- markdownlint-enable MD013 -->
 > [!TIP]
 > Quickstart