Add working examples and changelog docs pages

docs/changelog.md

@@ -0,0 +1,17 @@
+---
+title: Changelog
+---
+
+{%
+   includemarkdown "../README.md"
+   start="<!--changelog-start-->"
+   end="<!--changelog-end-->"
+%}
+
+<script>
+  // undo the scrollTop that the theme did on this page, as there are loads
+  // of toc entries and it's disorientating.
+  window.addEventListener('DOMContentLoaded', function() {
+    $('.wy-nav-side').scrollTop(0)
+  })
+</script>

docs/extra.css

@@ -29,7 +29,6 @@ h1, h2, h3, h4, h5, h6 {
     border-bottom: 1px solid  #e1e4e5;
     margin-bottom: 0.8em;
     padding-bottom: 0.2em;
-
 }
 
 .rst-content blockquote {

docs/working-examples.md

@@ -0,0 +1,20 @@
+---
+title: Working examples
+---
+
+{%
+   includemarkdown "../README.md"
+   start="<!--working-examples-start-->"
+   end="<!--working-examples-end-->"
+%}
+
+<style>
+.wy-nav-content {
+  /* this table benefits from a wider page */
+  max-width: 1000px;
+}
+.rst-content .section table img {
+  /* make the icons darker on this page */
+  filter: brightness(0.5);
+}
+</style>