re-arrange the user docs (#76)

* re-arrange the user docs

* Minor description edit

* update styles

* fix service links

Co-authored-by: kn0wmad <kn0wmad@protonmail.com>
Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com>

site/source/developer-docs/getting-started/sdk.rst

@@ -0,0 +1,97 @@
+.. _sdk:
+
+===========
+Embassy SDK
+===========
+
+Embassy SDK, or Software Development Kit, is a CLI (Command Line Interface) tool that aids in building and packaging services you wish to deploy to the Embassy.
+
+It mainly helps you validate that the necessary components of your package exist, and package all of those components into a special file type that is understood by EmbassyOS.
+
+To install, checkout the SDK step in :ref:`setting up your environment <environment-setup>`.
+
+Commands
+========
+
+To see a list of all available commands provided, run the following from an terminal window:
+
+.. code:: bash
+
+    embassy-sdk --help
+
+
+embassy-sdk init
+----------------
+
+Initialize the developer key for interacting with the SDK.
+
+By default, this creates the developer key at `/etc/embassy`. You might need to change ownership of this folder depending on your system permissions.
+
+.. code:: bash
+
+    chown <user> /etc/embassy
+
+Alternatively, you can write a config file with your desired developer location, it simply needs the following format:
+
+    .. code:: yaml
+
+        developer-key-path: /desired/path/to/key
+
+And load it by running:
+
+    .. code:: bash
+
+        embassy-sdk -c /path/to/config init
+
+
+embassy-sdk pack
+----------------
+
+This command takes the necessary package components and assembles them into the `s9pk` file format needed to install a service on EmbassyOS. It expects the following files to exist:
+
+- Manifest
+- Instructions
+- License
+- Icon
+
+If this command fails, the error response will indicate which component is missing.
+
+embassy-sdk verify
+-------------------
+
+This command verifies aspects about the components assembled into the `s9pk`, such as:
+
+- Ensures that all mounts are real volumes in the manifest
+- Ensures all cert volumes point to real interfaces in the manifest
+- Ensures all actions refer to real images in the manifest
+- Ensures all images are tagged correctly in the manifest
+- Ensures the icon is less than 100KB
+
+It should be run _after_ `embassy-sdk pack` in order to verify the validity of each component.
+
+If this command fails, the error message will indicate the mismatched details.
+
+embassy-sdk git-info
+--------------------
+
+This command outputs the git commit hash of the SDK version installed on your platform.
+
+embassy-sdk inspect
+-------------------
+
+This command contains several utilities for reading components once packaged into the `s9pk`. In development, it can be helpful to determine if each component is successfully included in the `s9pk` package.
+
+It contains the following subcommands, and requires the path to the `<pacakge-id>.s9pk` file as the last argument:
+
+- docker-images
+- hash
+- icon
+- instructions
+- license
+- manifest
+
+For example:
+
+.. code:: bash
+
+    embassy-sdk inspect instructions /path/to/<package-id>.s9pk