Try to get the LICENSE to be identified by GitHub.

LICENSE

@@ -1,9 +1,12 @@
-Copyright (c) 2017 Ben Balter
-Copyright (c) 2014, Tom Christie. All rights reserved.
-Copyright (c) 2019 Carlos Pereira Atencio
+BSD 2-Clause License
 
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
+Copyright (c) 2017, Ben Balter
+Copyright (c) 2014, Tom Christie
+Copyright (c) 2019, Carlos Pereira Atencio
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
 
 1. Redistributions of source code must retain the above copyright notice, this
    list of conditions and the following disclaimer.
@@ -12,13 +15,13 @@ are permitted provided that the following conditions are met:
    this list of conditions and the following disclaimer in the documentation
    and/or other materials provided with the distribution.
 
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -10,8 +10,8 @@ The original [Read The Docs](https://sphinx-rtd-theme.readthedocs.io/en/stable/)
 theme was created for the [Sphinx](https://www.sphinx-doc.org/) documentation
 generator, and so it is designed specifically for docs.
 
-Combined with [GitHub Pages](https://pages.github.com) it's great and easy way
-to document your projects.
+Combined with [GitHub Pages](https://pages.github.com) it's a great and easy
+way to document your projects!
 
 ### 🚧 Warning!
 
@@ -26,14 +26,19 @@ and any known issues are listed with the
 Contributions are very welcomed!
 
 
-## 🗂️ Table of contents
+## 🗂️ Readme Contents
 
-- [🚀 Using this theme with GitHub Pages](#-using-this-theme-with-gitub-pages)
-- [🖥️ Adding this theme to your Jekyll project](#-adding-this-theme-to-your-jekyll-project)
+- [🚀 Using this theme with GitHub Pages](#-using-this-theme-with-github-pages)
+- [🖥️ Adding this theme to your Jekyll project](#%EF%B8%8F-adding-this-theme-to-your-jekyll-project)
 - [👩‍💻 Development Instructions](#-development-instructions)
+    - [Run with Vagrant and a virtual machine](#run-with-vagrant-and-a-virtual-machine)
+    - [Run locally with Ruby](#run-locally-with-ruby)
+    - [Build the docs with MkDocs for comparison](#build-the-docs-with-mkdocs-for-comparison)
 - [👨‍👩‍👧‍👦 Contributing](#-contributing)
 - [⚖️ License](#%EF%B8%8F-license)
 
+Don't forget to also check out the [documentation](https://carlosperate.github.io/jekyll-theme-rtd)!
+
 
 ## 🚀 Using this theme with GitHub Pages
 
@@ -162,15 +167,16 @@ contributors are expected to adhere to the
 ## ⚖️ License
 
 The original theme is from
-[Read The Docs](https://github.com/readthedocs/sphinx_rtd_theme). Copyright (c)
-2013-2018 Dave Snider, Read the Docs, Inc. & contributors and released under
+[Read The Docs](https://github.com/readthedocs/sphinx_rtd_theme). Copyright ©
+2013-2018 Dave Snider, Read the Docs, Inc. & contributors, and released under
 the [MIT License](LICENSE-rtd).
 
 This theme is based on the [MkDocs](https://github.com/mkdocs/mkdocs)
 [`readthedocs` port](https://github.com/mkdocs/mkdocs/tree/1.0.4/mkdocs/themes/readthedocs).
 Copyright © 2014, Tom Christie, all rights reserved, and released under the
 [BSD 2-Clause "Simplified" License](LICENSE-mkdocs).
 
-The theme modifications to port it Jekyll can be seen [here](https://github.com/carlosperate/jekyll-theme-rtd/compare/dddce9f13fde24c03aee4533158c43091120d47e...master),
-this and all new features are released under the
+The theme modifications to port it Jekyll can be seen
+[here](https://github.com/carlosperate/jekyll-theme-rtd/compare/dddce9f13fde24c03aee4533158c43091120d47e...master).
+This and all new features are released under the
 [BSD 2-Clause "Simplified" License](LICENSE).