OTA-3594: adding restructured Antora-friendly content

-Adding Antora dir structure
- Break up content into individual file
- Setting up files for including in other repos
- Making options easier to read and more consistent with other
reference doc.
- Updated README to link to individual topic files rather than
all on one page.
- Added Mathias's requested HW and bootloader info
- Added xaviers requested NRE clause.

Signed-off-by: Merlin Carter <merlin.carter@here.com>

1 files changed, 17 insertions, 0 deletions

diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
new file mode 100644
index 0000000..d4b577b
--- /dev/null
+++ b/docs/modules/ROOT/nav.adoc
@@ -0,0 +1,17 @@
+// MC: NOTE ABOUT TOC 
+// Adding "pageroot" attr so that TOC that will also work directly in GitHub. Because...
+// In Antora the "pages" subdir is implcit added to the xref path at build time.
+// if you add "/pages" Antora will intepret it as "pages/pages".
+// The pages subdir is NOT implicit when viewing source files in Github.
+
+ifdef::env-github[:pageroot: pages/]
+ifndef::env-github[:pageroot:]
+
+.Guide to the Build Tools
+* xref:{pageroot}metaupdater-whatis.adoc[What are the build tools?]
+* xref:{pageroot}build.adoc[Build a disk image]
+* xref:{pageroot}supported-boards.adoc[Supported Boards]
+* xref:{pageroot}meta-updater-usage.adoc[How to]
+* xref:{pageroot}sota-variables.adoc[Configuration reference]
+* xref:{pageroot}dev-config.adoc[Development configuration]
+* xref:{pageroot}meta-updater-testing.adoc[Testing]
\ No newline at end of file