Add changelog, fix formatting and bump version

Author: grega

CHANGELOG.md

@@ -0,0 +1,15 @@
+# Change Log
+
+## 0.5.1
+
+### Added
+
+Further documentation better describing the Build HAT library components along with supported hardware.
+
+### Changed
+
+n/a
+
+### Removed
+
+n/a

README.md

@@ -31,15 +31,14 @@ Documentation
 -------------
 
 Instructions for regenerating the documentation can be found in
-docs/README.md.  Briefly, assuming you have the appropriate python
+`docs/README.md`. Briefly, assuming you have the appropriate python
 modules installed:
 
 ```
 $ (cd docs; make html)
 ```
 
-will rebuild the documentation.  The doc tree starts at
-``docs/build/html/index.html``
+will rebuild the documentation. The doc tree starts at `docs/build/html/index.html`
 
 
 Usage

VERSION

@@ -1 +1 @@
-0.5.0
+0.5.1

docs/conf.py

@@ -126,4 +126,4 @@
 html_additional_pages = {"index": "topindex.html"}
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'Hubdoc'
+htmlhelp_basename = 'BuildHATdoc'

docs/templates/topindex.html

@@ -1,14 +1,12 @@
 {% extends "layout.html" %}
 {% block body %}
 
-  <h1>Build HAT Documentation</h1>
+<h1>{{ _('Build HAT Documentation') }}</h1>
 
-  <p>
-    {{ _('Welcome! This is the documentation for the Raspberry Pi Build HAT') }}
-    {{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}.
-  </p>
+<p>{{ _('Welcome! This is the documentation for the Raspberry Pi Build HAT') }}{{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}.</p>
 
-  <table class="contentstable"><tr>
+<table class="contentstable">
+  <tr>
     <td width="40%" style="padding-left:2em;">
       <p class="biglink">
         <a class="biglink" href="{{ pathto("buildhat/index") }}">Library Reference</a><br/>
@@ -21,6 +19,7 @@ <h1>Build HAT Documentation</h1>
         <span class="linkdescr">License information</span>
       </p>
     </td>
-  </tr></table>
+  </tr>
+</table>
 
 {% endblock %}

docs/templates/versions.html

@@ -25,13 +25,10 @@
     </dl>
     <hr/>
     <dl>
-      <dt>External links</dt>
-        <dd>
-          <a href="http://www.micropython.org">micropython.org</a>
-        </dd>
-        <dd>
-          <a href="https://github.com/micropython/micropython">GitHub</a>
-        </dd>
+      <dt>Links</dt>
+      <dd>
+        <a href="https://github.com/RaspberryPiFoundation/python-build-hat">GitHub</a>
+      </dd>
     </dl>
   </div>
 </div>