some more words

components/mai.rst

@@ -21,3 +21,5 @@ If you only have one profile, you can simply execute ``mai`` to login:
     $ mai
     $ # credentials are now stored in ~/.aws/credentials
     $ aws ec2 describe-instances # example usage
+
+.. Note:: Mai will save its configuration in a YAML file in your home directory (``~/.config/mai/mai.yaml`` on Linux)

components/pierone.rst

@@ -3,3 +3,5 @@
 ========
 Pier One
 ========
+
+**Pier One** is STUPS' Docker registry with immutable tags, repo permissions, S3 backend and OAuth.

components/taupage.rst

@@ -93,6 +93,7 @@ source:
 **(required)**
 
 The source, the configured runtime uses to fetch your delpoyment artifact. For Docker, this is the Docker image.
+Usually this will point to a Docker image stored in :ref:`pierone`.
 
 ports:
 ------

user-guide/ssh-access.rst

@@ -16,5 +16,11 @@ Every team member can get access to any of the team's EC2 instances by using the
     $ ssh -A odd-eu-west-1.myteam.example.org # agent-forwarding must be used!
     $ ssh 172.31.146.1 # jump from bastion to private instance
 
+Piu will remember the URL of :ref:`even` and the hostname of :ref:`odd` in the local config file (``~/.config/piu/piu.yaml`` on Linux).
+You can overwrite settings on the command line:
+
+.. code-block:: bash
+
+    $ piu -O odd-eu-west-1.myotherteam.example.org 172.31.1.1 test