docs: split and add to docs

Author: MichaelCurrin

README.md

@@ -12,9 +12,9 @@
 
 <div align="center">
     <a href="https://michaelcurrin.github.io/">
-        <img src="/sample.png" 
-           alt="Sample screenshot" 
-           title="Go to site" 
+        <img src="/sample.png"
+           alt="Sample screenshot"
+           title="Go to site"
            width="500" />
     </a>
 </div>
@@ -28,36 +28,14 @@
 
 </div>
 
-Forked from the [github/personal-website](https://github.com/github/personal-website) repo. 
+Forked from the [github/personal-website](https://github.com/github/personal-website) repo.
 
 You can [fork](https://github.com/github/personal-website/fork) that original project and make your own.
 
 
-## Development
-> Notes for editing this repo
+## Documentation
 
-### Content and templates
-
-- `interests.html`: A heading and dynamic list of "My Interests," which is populated with the [topics](#topics) you list in your `_config.yml`.
-- `masthead.html`: A collection of your avatar, name, bio, and other metadata that's displayed prominently on all your webpages to help identify what the website is about.
-- `post-card.html`: A compact, summarized presentation of a blog post, re-used to display a listing of your latest blog posts.
-- `projects.html`: A heading and dynamic list of "My Projects," which is populated with a listing of your newest GitHub repositories.
-- `repo-card.html`: A compact, summarized presentation of a repository, re-used to display a listing of your GitHub repositories.
-- `thoughts.html`: A heading and dynamic list of "My Thoughts," which is populated with a listing of your latest blog posts.
-- `topic-card.html`: A compact, summarized presentation of a topic (defined in your `_config.yml`), re-used to display a listing of your interests.
-
-### Styles
-
-The website is pre-configured to use [GitHub's very flexible CSS framework called "Primer"](https://styleguide.github.com/primer/). It's currently referenced within your `styles.scss` file, using the CSS `@import` rule.
-
-See `/assets/styles.scss` Sass stylesheet. By editing this file, you can customize the website's color scheme, typography, and more.
-
-### Icons
-
-The Octicons gem is _not_ listed directly under [Dependency versions](https://pages.github.com/versions/), but it still works on GH Pages.
-
-- [octicons](https://rubygems.org/gems/octicons) on Ruby gems.
-- [octicons](https://github.com/primer/octicons) on GitHub. Linked to from the now-deprecated [jekyll-octicons](https://github.com/primer/jekyll-octicons) repo.
+See [docs](/docs/).
 
 
 ## License

docs/README.md

@@ -0,0 +1 @@
+# Documentation

docs/development.md

@@ -0,0 +1,26 @@
+# Development
+> Notes for editing this repo
+
+
+## Content and templates
+
+- `interests.html`: A heading and dynamic list of "My Interests," which is populated with the [topics](#topics) you list in your `_config.yml`.
+- `masthead.html`: A collection of your avatar, name, bio, and other metadata that's displayed prominently on all your webpages to help identify what the website is about.
+- `post-card.html`: A compact, summarized presentation of a blog post, re-used to display a listing of your latest blog posts.
+- `projects.html`: A heading and dynamic list of "My Projects," which is populated with a listing of your newest GitHub repositories.
+- `repo-card.html`: A compact, summarized presentation of a repository, re-used to display a listing of your GitHub repositories.
+- `thoughts.html`: A heading and dynamic list of "My Thoughts," which is populated with a listing of your latest blog posts.
+- `topic-card.html`: A compact, summarized presentation of a topic (defined in your `_config.yml`), re-used to display a listing of your interests.
+
+## Styles
+
+The website is pre-configured to use [GitHub's very flexible CSS framework called "Primer"](https://styleguide.github.com/primer/). It's currently referenced within your `styles.scss` file, using the CSS `@import` rule.
+
+See `/assets/styles.scss` Sass stylesheet. By editing this file, you can customize the website's color scheme, typography, and more.
+
+## Icons
+
+The Octicons gem is _not_ listed directly under [Dependency versions](https://pages.github.com/versions/), but it still works on GH Pages.
+
+- [octicons](https://rubygems.org/gems/octicons) on Ruby gems.
+- [octicons](https://github.com/primer/octicons) on GitHub. Linked to from the now-deprecated [jekyll-octicons](https://github.com/primer/jekyll-octicons) repo.

docs/installation.md

@@ -0,0 +1,8 @@
+# Installation
+
+
+### Install project packages
+
+```sh
+$ make install
+```

docs/sitemap.md

@@ -0,0 +1,29 @@
+# Sitemap
+
+I have a lot of GitHub Pages sites.
+
+The main one is set up in the Google SEO Console as:
+
+- `https://michaelcurrin.github.io/sitemap.xml`
+
+I then link to other sites in that sitemap, to ensure Google crawls them all.
+
+
+## Manual set up
+
+Sites listed in:
+
+- [\_data/gh_pages_sites.yml](/_data/gh_pages_sites.yml)
+
+I can preview as clickable links with:
+
+- [\_sites-test.md](/_sites-test.md)
+
+Currently ignore because of leading forward slash.
+
+
+## Automated set up
+
+Maybe one day I'll use the GitHub API to get all my repos and check if they have GitHub Pages enabled, then build the sitemap from that.
+
+Some sites with also have URL in the API response but will be outside of GitHub Pages and need to have their own sitemap and registration in Google SEO Console.

docs/usage.md

@@ -0,0 +1,13 @@
+# Usage
+
+### Start dev server
+
+```sh
+$ make serve
+```
+
+### Build
+
+```sh
+$ make build
+```