Rework workflow documentation

The workflow documentation is a bit of a mess. Rework the documentation:

• Split the details out of the platform guide, making it a better high level overview of Apertis targeted more at selling the platform.
• Create an architectural document covering the basics of the Apertis workflow and how the tools used by Apertis fit together. Use pictures to help explain.
• Detailed information about workflows shifted to guides
  • Packaging guide starting to be restructured to better cover workflows by adding sections.
  • Separating out description of component repository layout into its own guide.
  • Shift image creation details to Image building guide.

While I've noticed:

• Packages have been moved from repository based sub-directories under pkg/ to pkg/ its self. Update the URLs used on the website to reflect this.

Signed-off-by: Martyn Welch martyn.welch@collabora.com

content/architecture/platform-guide.md

@@ -18,7 +18,7 @@ lastmod = "2021-04-29"
 
 Apertis is a versatile open source distribution and associated infrastructure,
 originally tailored to automotive use cases, but which has grown to be a fit
-for a wide variety of electronic devices. Whilst Apertis provides components
+for a wide variety of electronic devices. While Apertis provides components
 both for deployment on target devices and to meet the needs of development
 workflows, these are clearly separated, with special care taken to ensure that
 components intended for deliverables are free from
@@ -83,8 +83,8 @@ On top of the shared core, each user has access to
 components that are not meant to be shared with other teams, both for
 experimentation and for product development.
 
-Contributions to the shared Apertis components follows Open Source Software
-(OSS) best practices with it's
+Contributions to the shared Apertis components follow Open Source Software
+(OSS) best practices with its
 [maintainer/contributor policies]( {{< ref "contributions.md" >}} )
 centered on code review and
 [continuous integration]( {{< ref "component_structure.md" >}} ).
@@ -126,7 +126,7 @@ example of how to implement fleet manangement.
 
 Applications can be deployed and updated in
 [application bundles]({{< ref "canterbury-legacy-application-framework.md" >}})
-(with a new [Flatpak based solution]({{< ref "application-framework.md" >}}) on
+(with a new [Flatpak-based solution]({{< ref "application-framework.md" >}}) on
 the way) without re-deploying the whole platform, decoupling the release and
 update cycle of the base software from that of each application.
 
@@ -161,7 +161,7 @@ are available to every team and since they are provided as a service they do
 not need to be duplicated for each developer. This ensures reproducibility,
 traceability and consistency during the whole product life cycle.
 
-## Key technologies
+# Key technologies
 
 Apertis makes heavy use of many open source technologies to form a strong platform:
 
@@ -174,6 +174,6 @@ Apertis makes heavy use of many open source technologies to form a strong platfo
   applicaiton profiles.
 - **OSTree** and **Flatpak** for safe, efficient and modular deployments
 - **D-Bus** providing inter-process communications, enabling privilege separation between the various system services and applications.
-- **Wayland** based compositor, providing a modern efficient display server.
+- **Wayland**-based compositor, providing a modern efficient display server.
 - **GStreamer** enabling multimedia playback