diff --git a/themes/psh-docs/layouts/shortcodes/version/only.html b/themes/psh-docs/layouts/shortcodes/version/only.html
index d8664b639c..8154e7226f 100644
--- a/themes/psh-docs/layouts/shortcodes/version/only.html
+++ b/themes/psh-docs/layouts/shortcodes/version/only.html
@@ -1,8 +1,8 @@
 <!-- Markdown passed between shortcode `vendor/inner` will render only if the current version = first passed variable -->
 <!-- For example, -->
-<!-- {{< vendor/only "1" >}} -->
+<!-- vendor/only "1" -->
 <!-- platform variable:get  -->
-<!-- {{< /vendor/only >}} -->
+<!-- /vendor/only -->
 <!-- When the site is built, the `platform` command will appear iff vendor.config.version = 1 in params.yaml -->
 {{- $version := .Site.Params.vendor.config.version -}}
 {{- if eq $version ( int (.Get 0)) -}}
diff --git a/themes/psh-docs/layouts/shortcodes/version/specific.html b/themes/psh-docs/layouts/shortcodes/version/specific.html
index b4041f2287..0ff1c4dcd1 100644
--- a/themes/psh-docs/layouts/shortcodes/version/specific.html
+++ b/themes/psh-docs/layouts/shortcodes/version/specific.html
@@ -2,11 +2,11 @@
 <!-- Key 1: Version 1; the first Inner prior to the dividing character -->
 <!-- Key 2: Version 2; the second Inner after the dividing character -->
 <!-- For example, -->
-<!-- {{< vendor/specific >}} -->
+<!-- vendor/specific -->
 <!-- platform variable:get  -->
-<!-- \<---\>  -->
+<!-- (divider: see $splitVersionChar below)  -->
 <!-- friday variable:get -->
-<!-- {{< /vendor/specific}} -->
+<!-- /vendor/specific -->
 {{- $page := .Page -}}
 {{- $version := .Site.Params.vendor.config.version -}}
 {{- $splitVersionChar := "<--->" -}}