Merge pull request lxc#483 from stgraber/main

doc: Add support page and section introductions

Author: gibmat

doc/.wordlist.txt

@@ -13,6 +13,7 @@ EOF
 FAT
 formatters
 Furo
+FuturFusion
 GiB
 Github
 Incus

doc/getting-started.md

@@ -1,4 +1,10 @@
 # Getting started
+Let's get you started with IncusOS!
+
+Whether you want to run it on some physical hardware or in a virtual
+machine, you'll have to make sure your system meets the current system
+requirements, then get yourself an image and finally install it on your
+system.
 
 ```{toctree}
 :maxdepth: 1

doc/reference.md

@@ -1,4 +1,8 @@
 # Reference
+This reference documentation covers every aspect of IncusOS.
+
+It includes details for all installable applications, system services and general system configuration.
+In addition, it also provides some detailed background information on core features of IncusOS.
 
 ```{toctree}
 :maxdepth: 1

doc/reference/applications.md

@@ -1,4 +1,15 @@
 # Applications
+IncusOS itself doesn't listen on the network. For the system to be
+accessible and manageable over the network, it requires a primary
+application to be installed.
+
+The primary application is responsible for listening on the network and
+for handling user authentication. It then provides access to the IncusOS
+management API through its own API.
+
+IncusOS also supports additional (non-primary) applications which can
+extend the base system (for example for debugging) or provide additional
+features to another application.
 
 ```{toctree}
 :maxdepth: 1

doc/reference/applications/shared-api.md

@@ -10,7 +10,9 @@ If needed, an application can be restarted by running
 incus admin os application restart <name>
 ```
 
-Note: It is expected to receive an EOF error since the application's HTTP REST endpoint will be restarted along with the application.
+```{note}
+It is expected to receive an EOF error since the application's HTTP REST endpoint will be restarted along with the application.
+```
 
 ## Backing up the application
 
@@ -44,7 +46,9 @@ Restore the backup by running
 incus admin os application restore <name> backup.tar.gz
 ```
 
-Note: It is expected to receive an EOF error since the application's HTTP REST endpoint will be restarted along with the application after performing the restoration.
+```{note}
+It is expected to receive an EOF error since the application's HTTP REST endpoint will be restarted along with the application after performing the restoration.
+```
 
 ## Factory reset
 
@@ -58,4 +62,6 @@ Reset the application by running
 incus admin os application factory-reset <name>
 ```
 
-Note: It is expected to receive an EOF error since the application's HTTP REST endpoint will be restarted along with the application after resetting the application.
+```{note}
+It is expected to receive an EOF error since the application's HTTP REST endpoint will be restarted along with the application after resetting the application.
+```

doc/reference/services.md

@@ -1,4 +1,9 @@
 # Services
+IncusOS system services are optional system-wide features, typically
+used to integrate with an external system.
+
+The majority of services today are centered around connecting to
+external storage or networking.
 
 ```{toctree}
 :maxdepth: 1

doc/reference/system.md

@@ -1,4 +1,11 @@
 # System configuration
+IncusOS runs a management daemon which is responsible not just of
+starting and stopping the various applications and services but also of
+correctly bringing up system networking and storage, handle updates and
+manage encryption keys.
+
+Those core system functions each have their own state and configuration
+as well as relevant actions.
 
 ```{toctree}
 :maxdepth: 1

doc/support.md

@@ -1 +1,28 @@
 # Support
+## Releases
+IncusOS uses a rolling release model.
+
+A new stable release is tagged at least once a week to pick up the latest bug fixes to the Linux kernel, Incus and any other component that we ship.
+
+When reporting an issue, please first ensure that your system is running the latest stable release.
+
+```{note}
+The use of other update channels like `testing` isn't supported and should be limited to development and debugging use on non-critical systems.
+```
+
+## Support and community
+
+The following channels are available for you to interact with the IncusOS community.
+
+## Bug reports
+
+You can file bug reports and feature requests at: [`https://github.com/lxc/incus-os/issues/new`](https://github.com/lxc/incus-os/issues/new)
+
+## Community support
+
+Community support is handled at: [`https://discuss.linuxcontainers.org`](https://discuss.linuxcontainers.org)
+
+## Commercial support
+
+Commercial support is currently available from [Zabbly](https://zabbly.com) for standalone IncusOS deployments.
+For large scale deployments of IncusOS, support can be obtained from [FuturFusion](https://futurfusion.io) as part of FuturFusion Cloud.