diff --git a/resources/README.md b/resources/README.md
index e69de29b..854d7808 100644
--- a/resources/README.md
+++ b/resources/README.md
@@ -0,0 +1,9 @@
+# `mogenerator` related resources
+
+## For template editors
+
+If you're editing `mogenerator` template files with Visual Studio Code, you can add syntax highlighting support for `.motemplate` files like [the ones included with `mogenerator`](../templates).
+
+![](mogenerator-template-vscode/sample.png)
+
+To use syntax highlighting, copy the `mogenerator-template-vscode` directory into `~/.vscode/extensions/` on your Mac, and relaunch Visual Studio Code.