diff --git a/content/content-management/front-matter.md b/content/content-management/front-matter.md
index b79fc5fd8..8c2d0dc05 100644
--- a/content/content-management/front-matter.md
+++ b/content/content-management/front-matter.md
@@ -111,11 +111,11 @@ See [site configuration][] for more information.
 
 ## Parameters
 
-## Ordering Content
+## Assigning `weight` for Ordering
 
-### Assigning `weight` to Content
+### Assigning `weight` for Ordering Content
 
-### Assigning `weight` to Taxonomies
+### Assigning `weight` for Ordering Taxonomies
 
 ## Front Matter Format Specs
 
diff --git a/content/templates/local-file-templates.md b/content/templates/local-file-templates.md
index 64479011e..d46056bf3 100644
--- a/content/templates/local-file-templates.md
+++ b/content/templates/local-file-templates.md
@@ -38,18 +38,18 @@ in effect becomes both:
 So, let's create a new shortcode using `readDir`:
 
 **layouts/shortcodes/directoryindex.html**
+
 ```html
-{{< readfile "layouts/shortcodes/directoryindex.html" >}}
+{{</* readfile "layouts/shortcodes/directoryindex.html" */>}}
 ```
-For the files in any given directory,
-this shortcode usefully lists their basenames and sizes,
-while providing links to them.
+
+For the files in any given directory, this shortcode usefully lists their basenames and sizes, while providing links to them.
 
 Already&mdash;actually&mdash;this shortcode
 has been included in this very web site.
 So, let's list some of its CSS files.
 (If you click on their names, you can reveal the contents.)
-{{<   directoryindex path="/static/css" pathURL="/css"   >}}
+{{</*   directoryindex path="/static/css" pathURL="/css"   */>}}
 <br />
 This is the call that rendered the above output:
 ```html