diff --git a/README.md b/README.md
index fcf76d11..06765a2a 100644
--- a/README.md
+++ b/README.md
@@ -125,6 +125,8 @@ Options
 Working examples
 ----------------
 
+<!--working-examples-start-->
+
 Here are some repos that use cibuildwheel.
 
 <!-- START bin/projects.py -->
@@ -251,6 +253,8 @@ Here are some repos that use cibuildwheel.
 >
 > <sup>I'd like to include notes here to indicate why an example might be interesting to cibuildwheel users - the styles/technologies/techniques used in each. Please include that in future additions!</sup>
 
+<!--working-examples-end-->
+
 Legal note
 ----------
 
@@ -263,6 +267,8 @@ This is similar to static linking, so it might have some licence implications. C
 Changelog
 =========
 
+<!--changelog-start-->
+
 ### 1.7.1
 
 _3 December 2020_
@@ -670,6 +676,8 @@ _31 March 2017_
 
 - 🌟 First public release!
 
+<!--changelog-end-->
+
 Contributing
 ============
 
diff --git a/docs/changelog.md b/docs/changelog.md
new file mode 100644
index 00000000..f4c1b679
--- /dev/null
+++ b/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>
diff --git a/docs/extra.css b/docs/extra.css
index 5da96b0b..0a4dad6b 100644
--- a/docs/extra.css
+++ b/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 {
diff --git a/docs/working-examples.md b/docs/working-examples.md
new file mode 100644
index 00000000..a769ff53
--- /dev/null
+++ b/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>
diff --git a/mkdocs.yml b/mkdocs.yml
index 4a10a6d9..5bf1b022 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -20,7 +20,9 @@ nav:
   - deliver-to-pypi.md
   - cpp_standards.md
   - faq.md
+  - working-examples.md
   - contributing.md
+  - changelog.md
 
 markdown_extensions:
   - fenced_code