docs: update documentation

Author: saitho

Documentation/SUMMARY.md

@@ -7,30 +7,20 @@
 * [Workflow](introduction/workflow.md)
 * [Project definition](introduction/project-definition.md)
 * [Getting started](introduction/getting-started.md)
+* [CLI configuration](introduction/cli-configuration.md)
+* [Commands](introduction/commands.md)
 
 ## Development
 
 * [Basics](development/basics.md)
 * [Events](development/events.md)
 
-## StackHead CLI
-
-* [Installation](stackhead-cli/installation.md)
-* [Commands](stackhead-cli/commands.md)
-* [Configuration](stackhead-cli/cli-configuration.md)
-
 ## StackHead modules
 
 * [About modules](stackhead-modules/stackhead-modules.md)
 * [List of modules](stackhead-modules/list-of-modules.md)
 * [Development](stackhead-modules/development/README.md)
 
-## Ansible Collection <a id="ansible-playbooks"></a>
-
-* [Installation](ansible-playbooks/installation.md)
-* [Inventory](ansible-playbooks/inventory.md)
-* [Playbooks](ansible-playbooks/playbooks.md)
-
 ## Technical Documentation
 
 * [Terraform](technical-documentation/terraform.md)

Documentation/ansible-playbooks/installation.md

@@ -0,0 +1,33 @@
+# Configuration
+
+StackHead will look for a file named `.stackhead-cli.yml` in the working directory or in the home directory of the user executing the command.
+
+This file is used to configure which StackHead modules to use.
+
+You may define additional module configurations within the `modules_config` key.
+See example below for setting the setting _server_names_hash_bucket_size_ for the Nginx proxy module.
+
+## Full annotated configuration
+
+```yaml
+---
+modules:
+  proxy: nginx
+  container: docker
+  plugins:
+    - portainer
+  dns:
+    - cloudflare
+modules_config:
+  nginx: # config settings for Nginx module
+    certificates_email: "my-certificates-mail@mydomain.com" # Email address used for creating SSL certificates. Will receive notice when they expire.
+    config:
+      server_names_hash_bucket_size: 128
+terraform:
+  update_interval: "*-*-* 4:00:00" # perform Terraform update everyday at 4am, see Unix timer "OnCalendar" setting
+```
+
+{% hint style="info" %}
+Please look at the individual README files of the modules for all available configuration settings.
+{% endhint %}
+

Documentation/ansible-playbooks/inventory.md

@@ -14,5 +14,4 @@ The following commands are available in StackHead CLI:
 | `project destroy [path to project definition] [ip address]` | Remove a deployed project |
 | `project validate [path to project definition]` | Validate a project definition file |
 | `cli validate [path to cli configuration]` | Validate a StackHead CLI configuration file |
-| `module validate [path to module file]` | Validate a StackHead module file |
 

Documentation/ansible-playbooks/playbooks.md

@@ -8,10 +8,12 @@ description: >-
 
 You will require:
 
-* StackHead CLI \(see [Installation Guide](../stackhead-cli/installation.md)\)
+* StackHead CLI binary \(see [GitHub releases page](https://github.com/getstackhead/stackhead/releases)\)
 * a top level domain
 * a web server with SSH root access
 
+If you wish to change the software used for proxy or containers, please [create a CLI configuration file](cli-configuration.md).
+
 ## Creating a project definition
 
 Create a new project definitions file at `./stackhead/example_app.yml` and the following content:

Documentation/introduction/cli-configuration.md

@@ -1,10 +1,12 @@
 # Workflow
 
-StackHead utilizes Ansible and Terraform to set up your projects.
+StackHead utilizes Terraform to set up your projects.
 
+Outdated process image:
 ![StackHead process](../.gitbook/assets/stackhead-process.png)
 
-The figure above illustrates the general StackHead workflow. StackHead provides custom Ansible playbooks for installing required software on a remote server \(setup\) and configuring your projects \(deployment\).
+The figure above illustrates the general StackHead workflow.
+StackHead provides tooling for installing required software on a remote server \(setup\) and configuring your projects \(deployment\).
 
 The highlighted terms are explained in further detail below.
 
@@ -18,16 +20,17 @@ Based on the project definition file, StackHead will take care setting up the re
 
 ## Server setup
 
-During server setup all software and utilities that are required to set up your projects with StackHead are installed. Such may include Terraform, container management software \(e.g. Docker\) and web server software \(e.g. Nginx\). You'll have to run the server setup before you can deploy projects onto it.
-
-The server setup is executed by running the respective Ansible playbook.
+During server setup all software and utilities that are required to set up your projects with StackHead are installed.
+Such may include Terraform, container management software \(e.g. Docker\) and web server software \(e.g. Nginx\). You'll have to run the server setup before you can deploy projects onto it.
 
 ## Project deployment
 
-Setting up a project is called deployment and is done by running the respective Ansible playbook. This will create all project-related resources such as web server configuration, SSL certificates and start up containers.
+Setting up a project is called deployment.
+A deployment will create all project-related resources such as reverse proxy configuration, SSL certificates and it will start up containers.
 
 {% hint style="info" %}
 Only servers that have been set up using the StackHead **server setup** can be deployed onto!
+In the future it will be possible to deploy onto servers not provisioned by StackHead (see https://github.com/getstackhead/stackhead/issues/169).
 {% endhint %}
 
 ## Resource management