switch Disqus for Commentio for comments form

_config.yml

@@ -72,6 +72,7 @@ defaults:
     values:
       layout: "page"
       comments: true
+      # if you don't want to use Commento.io and just hide comments, change true to false wherever you see the comments property
       search: true
       sidebar: home_sidebar
       topnav: topnav
@@ -81,7 +82,6 @@ defaults:
       type: "tooltips"
     values:
       layout: "page"
-      comments: true
       search: true
       tooltip: true
 
@@ -92,6 +92,7 @@ defaults:
     values:
       layout: "post"
       comments: true
+      # if you don't want to use Commento.io and just hide comments, change true to false wherever you see the comments property
       search: true
       sidebar: home_sidebar
       topnav: topnav

_includes/commento.html

@@ -1,4 +1,4 @@
-{% unless page.comments == "no_comments" %}
+{% unless page.comments == false %}
 <div id="commento"></div>
 <script src="https://cdn.commento.io/js/commento.js"></script>
 <noscript>Please enable JavaScript to load the comments.</noscript>

index.md

@@ -301,6 +301,10 @@ Leave the output as `output: pdf` for these frontmatter pages so that they don't
 
 For more detail on the sidebar, see [Sidebar navigation][mydoc_sidebar_navigation] and [YAML tutorial][mydoc_yaml_tutorial].
 
+## Comments
+
+The theme integrates [Commento.io](https://commento.io/) for comments below pages and posts. (This commenting service doesn't inject controversial tracking ads like Disqus does.) You will need to Commento.io account + plan ($5/month) to authorize Commento with your domain (no other configuration should be required). If you don't want comments, in the \_config.yml file, change the `comments: true` properties (under `defaults`) to `comments: false` in every instance. Then in the commento.html include file (inside \_includes), the `{% raw %}{% unless page.comments == false %} ... {% endunless %}{% endraw %}` logic will not insert the Commentio form.
+
 ## Relative links and offline viewing
 
 This theme uses relative links throughout so that you can view the site offline and not worry about which server or directory you're hosting it. It's common with tech docs to push content to an internal server for review prior to pushing the content to an external server for publication. Because of the need for seamless transferrence from one host to another, the site has to use relative links.