Update homepage content (#9)

Author: thekaveman

_includes/about.html

@@ -0,0 +1,16 @@
+<h2>What is this site?</h2>
+
+<p>
+    This is Cal-ITP's
+    <a href="https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites">
+        GitHub Pages organization site</a>, served under a custom domain using a
+        <a href="https://github.com/cal-itp/cal-itp.github.io/blob/main/CNAME">CNAME</a> file.
+</p>
+<p>
+    This site is the root of Cal-ITP's GitHub Pages project sites, which are the other repositories that have GitHub Pages enabled. These
+    sites are automatically available at <code>https://docs.calitp.org/repo-name</code>.
+</p>
+<p>
+    To create a simple Markdown-based documentation site, see our instructions at:
+    <a href="https://docs.calitp.org/mkdocs-template">https://docs.calitp.org/mkdocs-template</a>
+</p>

_includes/repos/index.html

@@ -1,3 +1,5 @@
+<h2>Browse our projects</h2>
+
 <div class="repo-list">
 {% assign repos = site.data.repos | sort: "updated_at" | reverse %}
 {% for repo in repos %}

index.html

@@ -2,25 +2,6 @@
 layout: default
 ---
 
-<h2>Browse our projects</h2>
+{% include about.html %}
 
 {% include repos/index.html %}
-
-<h2>What is this site for?</h2>
-<p>
-    This is a GitHub Pages <em>organization site</em>, created in a repository named with the pattern
-    <code>org-name.github.io</code>. For Cal-ITP this is
-    <a href="https://github.com/cal-itp/cal-itp.github.io">cal-itp.github.io</a>.
-</p>
-<p>
-    Like all GitHub Pages sites, organization sites can define a
-    <a href="https://github.com/cal-itp/cal-itp.github.io/blob/main/CNAME"><code>CNAME</code></a> file to customize the domain.
-</p>
-<p>
-    An organization site serves as the root of that organization's <em>project sites</em>, which are just the other
-    repositories within the organization that have GitHub Pages enabled.
-</p>
-<p>
-    With the custom domain configured here, all Cal-ITP GitHub Pages sites are automatically available at
-    <code>https://docs.calitp.org/repo-name</code>.
-</p>