docs: Add missing docs

Add a few minimal documents to allow all the documentation in this
repository to be navigated from the top-level README.

Fixes #1681.

Signed-off-by: James O. D. Hunt <[email protected]>

README.md

@@ -25,6 +25,7 @@ For details of the other Kata Containers repositories, see the
 * [Community](#community)
     * [Contact](#contact)
 * [Further information](#further-information)
+* [Additional packages](#additional-packages)
 
 ## Introduction
 
@@ -170,3 +171,8 @@ See the
 [project table of contents](https://github.com/kata-containers/kata-containers)
 and the
 [documentation repository](https://github.com/kata-containers/documentation).
+
+## Additional packages
+
+For details of the other packages contained in this repository, see the
+[package documentation](pkg).

pkg/README.md

@@ -0,0 +1,10 @@
+# Kata golang packages
+
+This repository contains a number of packages in addition to the
+[`virtcontainers`](../virtcontainers) package:
+
+| Package name | Description |
+|-|-|
+| [`katatestutils`](katatestutils) | Unit test utilities. |
+| [`katautils`](katautils) | Utilities. |
+| [`signals`](signals) | Signal handling functions. |

pkg/katautils/README.md

@@ -0,0 +1,4 @@
+# Kata utilities packages
+
+The `katautils` package contains useful functions that are shared by various
+parts of the codebase, including the runtime and the container v2 shim.

pkg/signals/README.md

@@ -0,0 +1,4 @@
+# Signals package
+
+The `signals` package contains common signal handling functions that are shared by
+the binaries built in this repository.

virtcontainers/README.md

@@ -21,6 +21,8 @@ Table of Contents
    * [Devices](#devices)
       * [How to pass a device using VFIO-passthrough](#how-to-pass-a-device-using-vfio-passthrough)
    * [Developers](#developers)
+   * [Persistent storage plugin support](#persistent-storage-plugin-support)
+   * [Experimental features](#experimental-features)
 
 # What is it ?
 
@@ -153,6 +155,8 @@ The Sandbox has to be running.
 
 An example tool using the `virtcontainers` API is provided in the `hack/virtc` package.
 
+For further details, see the [API documentation](documentation/api/1.0/api.md).
+
 # Networking
 
 `virtcontainers` supports the 2 major container networking models: the [Container Network Model (CNM)][cnm] and the [Container Network Interface (CNI)][cni].
@@ -324,3 +328,11 @@ tooling.
 
 For information on how to build, develop and test `virtcontainers`, see the
 [developer documentation](documentation/Developers.md).
+
+# Persistent storage plugin support
+
+See the [persistent storage plugin documentation](persist/plugin).
+
+# Experimental features
+
+See the [experimental features documenation](experimental).