Inline pages into docs/index.md and tweak contributing.md

Author: microbit-grace

docs/contributing.md

@@ -11,12 +11,8 @@ nav_order: 6
 Thanks for looking here! We'd love your help. The micro:bit project is only
 possible through contributions of companies and individuals around the world.
 
-This project is managed on GitHub, and the best way to contribute is to jump
-into the GitHub issue tracker to see what is available. Planned features are
-marked with the "enhancement" label, and know issues are marked with the "bug"
-label.
-
-[https://github.com/microbit-foundation/microbit-universal-hex/issues](https://github.com/microbit-foundation/microbit-universal-hex/issues)
+This project is managed on [GitHub](https://github.com/microbit-foundation/microbit-universal-hex), and the best way to contribute is to jump
+into the [GitHub issue tracker](https://github.com/microbit-foundation/microbit-universal-hex/issues) to see what is available.
 
 If you're interested in working on any of these items, please respond to an
 existing issue, or file a new one, and mention @microbit-carlos.
@@ -37,8 +33,7 @@ occur.
 
 ## Bugs
 
-Please report any bugs in the GitHub issue tracker:
-https://github.com/microbit-foundation/microbit-universal-hex/issues
+Please report any bugs in the [GitHub issue tracker](https://github.com/microbit-foundation/microbit-universal-hex/issues).
 
 ## Development Workflow
 

docs/img/api-screenshot-2.png

@@ -12,35 +12,44 @@ nav_order: 1
 
 Create Universal Hex files for the micro:bit.
 
-- [micro:bit Universal Hex Specification](https://github.com/microbit-foundation/spec-universal-hex) contains a lot more information
-  about the file data format.
-- [GitHub](https://microbit-foundation.github.io/microbit-universal-hex/) contains general documentation for this
-  library.
-- [The micro:bit Tech Site](https://tech.microbit.org) contains general technical information about the
-  micro:bit.
-- [Universal Hex Creator demo](./examples/webtool.html)
-- [Universal Hex Splitter demo](./examples/separate.html)
-
----
-
 This is the documentation for the micro:bit Universal Hex library.
 
 Here you will find the available public API to convert Intel Hex strings into Universal Hex strings and vice-versa.
 
-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.
+## Universal Hex format
 
-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
+The micro:bit Universal Hex format is a superset of the
+[Intel Hex file format](https://en.wikipedia.org/wiki/Intel_HEX) designed to be
+able to include data for multiple targets into a single file. A Universal Hex file can contain the binary data for multiple micro:bit
+board versions. This allows the creation of a hex file that will work on micro:bit V1 and V2.
+
+Detailed information of the Universal Hex format can be found in the [specification](https://github.com/microbit-foundation/spec-universal-hex).
+
+This TypeScript/JavaScript library can be used to create a
 micro:bit Universal Hex from two or more micro:bit Intel Hex files.
 
-## Navigation
+## Online tool
+
+An implementation example can be found in the [webtool.html](./examples/webtool.html)
+in the repository and it is hosted in the
+[micro:bit Tech Site](ttps://tech.microbit.org).
+
+This web tool can generate a Universal Hex from an Intel Hex file for micro:bit
+V1 and an Intel Hex file for micro:bit V2.
+
+- [Universal Hex Creator](https://tech.microbit.org/software/universal-hex-creator/)
+- [Universal Hex Separator](https://microbit-foundation.github.io/microbit-universal-hex/examples/separate.html)
+
+## Related documentation
+
+[micro:bit Universal Hex Specification](https://github.com/microbit-foundation/spec-universal-hex) contains a lot more information
+about the file data format.
+
+[GitHub](https://microbit-foundation.github.io/microbit-universal-hex/) contains general documentation for this
+library.
 
-- ⬆️ The header at the top contains a search bar
-- ⬅️ The menu on the left shows you the available documentation pages
-- ⬇️ If you'd like to contribute to the docs there is an edit link at the footer
+[The micro:bit Tech Site](https://tech.microbit.org) contains general technical information about the
+micro:bit.
 
 ## License
 

docs/img/api-screenshot.png

@@ -10,8 +10,6 @@
   "projectDocuments": [
     // Order as per left nav
     "./docs/quick-guide.md",
-    "./docs/uh-format.md",
-    "./docs/online-tool.md",
     "./docs/contributing.md"
   ],
   "readme": "./docs/index.md",