docs: More tweaks to text and formatting.

Author: microbit-carlos

README.md

@@ -18,7 +18,7 @@ https://microbit-foundation.github.io/microbit-universal-hex/.
 
 ## Web Tool
 
-<img width="30%" alt="microbit-universal-hex logo" src="docs/img/web-tool-screenshot.png" align="left">
+<img width="18%" alt="microbit-universal-hex logo" src="docs/img/web-tool-screenshot.png" align="left">
 
 An implementation example can be found in the
 [docs/examples/webtool.html](docs/examples/webtool.html) file. This web tool can
@@ -31,4 +31,4 @@ https://tech.microbit.org/software/universal-hex-creator/
 
 This software is under the MIT open source license.
 
-SPDX-License-Identifier: MIT
+[SPDX-License-Identifier: MIT](LICENSE.md)

docs/_config.yml

@@ -11,6 +11,11 @@ kramdown:
 exclude:
   - api-readme.md
 
+# Need to include files with underscore for Typedoc output pages
+include:
+  - '_*_.html'
+  - '_*_.*.html'
+
 # Just The Docs settings
 
 logo: 'img/microbit-uh-logo-text.png'

docs/api-docs.md

@@ -7,9 +7,11 @@ nav_order: 3
 # API Documentation
 
 The API documentation is generated independently of the rest of these docs and
-can be found here:
+can be found in this URL:
 [https://microbit-foundation.github.io/microbit-universal-hex/api/](https://microbit-foundation.github.io/microbit-universal-hex/api/)
 
+[Click here to open the API docs](api/){: .btn .btn-purple }
+
 The source code is well annotated with docstring and
 [TypeDoc](http://typedoc.org) is used to generate the API pages.
 

docs/img/api-screenshot-2.png

@@ -10,7 +10,7 @@ nav_order: 1
 
 {: .fs-9 }
 
-<img alt="microbit-universal-hex logo" src="img/microbit-uh-logo.png" style="max-height: 164px; float: left; padding-right: 16px;">
+<img alt="microbit-universal-hex logo" src="img/microbit-uh-logo.png" style="max-height: 160px; float: left; padding-right: 16px;">
 
 Create Universal Hex files for the micro:bit.
 {: .fs-6 .fw-300 }
@@ -25,10 +25,10 @@ Create Universal Hex files for the micro:bit.
 
 This is the documentation for the micro:bit Universal Hex library.
 
-The original hex files for the micro:bit were using the
-[Intel Hex format](https://en.wikipedia.org/wiki/Intel_HEX). With the micro:bit
-V2 release a new hex format was created to be able to flash any micro:bit
-version with a single file.
+Originally the micro:bit hex files used the
+[Intel Hex format](https://en.wikipedia.org/wiki/Intel_HEX) and with the
+micro:bit V2 release a new hex format was created to be able to flash any
+micro:bit board version with a single file.
 
 The Universal Hex file format can contain the binary data for multiple micro:bit
 board versions and this TypeScript/JavaScript library can be used to create a