Add documentation for new custom helpers

Author: mfisher87

for-instructors/helpers.md

@@ -0,0 +1,37 @@
+# 🪄 Helpers
+
+This repository includes a `plugin-custom-directives.mjs` file which defines custom
+directives that will save some time authoring certain repeated elements.
+
+## Git commit checkpoint directive
+
+```myst
+:::{gitCommitCheckpoint} my commit message
+:::
+```
+
+:::{gitCommitCheckpoint} my commit message
+:::
+
+
+## "You should notice..." directive
+
+``````myst
+:::{youShouldNotice}
+...the `{youShouldNotice}` directive fully supports markdown in the body.
+This means you can, for example include some code:
+
+```python
+print("Some code!")
+```
+:::
+``````
+
+:::{youShouldNotice}
+...the `{youShouldNotice}` directive fully supports markdown in the body.
+This means you can, for example include some code:
+
+```python
+print("Some code!")
+```
+:::

for-instructors/style-guide.md

@@ -209,6 +209,30 @@ E.g.:
 :::
 ```
 
+**As a shortcut, you can use the `{youShouldNotice}` directive.**
+See [](./helpers.md).
+
+
+#### Committing
+
+Use 💾 in a callout to indicate that the user should stop and do a commit now.
+Provide the full set of commands the user should run.
+
+``````{myst}
+:::{important} 💾 Commit & push to GitHub
+:icon: false
+
+```bash
+git add .
+git commit -m "Commit message"
+git push -u origin main
+```
+:::
+``````
+
+**As a shortcut, you can use the `{gitCommitCheckpoint}` directive.**
+See [](./helpers.md).
+
 
 ### Voice / language