Cleanup docs

Linted docs, and addressed Markdown formatting issues,
as much seemed to be copied directly from the ReStructuredText docs.

This commit applies to issue FFTK-4610, "…lint docs…"

Signed-off-by: Katrina Prosise <katrina.prosise@foundries.io>

Author: kprosise

docs/architecture.md

@@ -2,12 +2,13 @@
 
 ## Part of the FoundriesFactory™ Platform
 
-`aktualizr-lite` is a key component of FoundriesFactory™, the platform offered by Foundries.io provides 
-end-to-end solution for IoT and Edge devices producers to build and OTA update OS and applications on their devices.
-It is embedded into [the Foundries.io™ Linux® microPlatform (LmP)](https://docs.foundries.io/latest/reference-manual/linux/linux.html) - Linux-based OS composed by means of [Yocto Framework](https://docs.yoctoproject.org/).
+`aktualizr-lite` is a key component of Foundries.io™ FoundriesFactory® platform.
+The platform provides an end-to-end solution for IoT and Edge devices producers to build and OTA update both the OS and applications.
+It is embedded into [the Foundries.io™ Linux® microPlatform (LmP)](https://docs.foundries.io/latest/reference-manual/linux/linux.html)
+—a Linux-based OS built by means of [The Yocto Project](https://docs.yoctoproject.org/).
 
-FoundriesFactory™ enables:
-1. **Assembling custom Linux-based OS through the Yocto framework**
+FoundriesFactory enables:
+1. **Assembling custom Linux-based OS through the Yocto Project**
 
 2. **CI-Driven Builds and Deployments**
    1. A CI service builds your custom OS and publishes it as an OSTree repository.
@@ -17,16 +18,16 @@ FoundriesFactory™ enables:
    Updates are signed and verified using the TUF framework, and delivered using a proprietary
    Wave mechanism that enables controlled rollout of updates across fleets of devices.
 
-
 ## System Overview
-The following diagram depicts conceptual architecture on the FoundriesFactory solution.
+
+The following diagram depicts the conceptual architecture on the FoundriesFactory platform.
 ![Aktualizr-lite architecture](img/FoundriesFactory_OTA_conceptual_architecture.png "FoundriesFactory™ OTA update system")
 
 `aktualizr-lite` is a component running on devices and performs OTA update through interaction with the Device Gateway,
-the OSTree Service, and a container registry (FoundriesFactory's or 3rd party, e.g. github container registry)
+the OSTree Service, and a container registry (FoundriesFactory's or 3rd party, e.g. GitHub container registry)
 
 The following diagram shows the key components used in aktualizr-lite
-and how they interact with FountriesFactory™ services.
+and how they interact with FountriesFactory services.
 
 ![Aktualizr-lite architecture](img/aktualizr-lite.png "Aktualizr-lite architecture")