Update documentation.

README.md

@@ -15,11 +15,20 @@ A command line tool for andock.
 * drush support including drush sql-sync without extra ssh container.
 * Easy to integrate in your CI environment.
 
+## For what can you use andock?
+* Host your project including environments support for every branch.
+* Host your project on acquia, platform.sh etc. Use andock for unlimited development environment.
+* Use andock to host review environments for qa suites. 
+## How can I use andock
+* As docksal addon
+* As a docker image inside your CI
+* As a standalone command line tool.
+
 ## Commands:
 ![alt text](docs/commands.png "Logo Title Text 1")
 
 
 # Getting started?
 
 * [See documentation](https://andock-ci-pipeline.readthedocs.io/en/latest/)
-* [5 minutes setup](https://andock-ci-pipeline.readthedocs.io/en/latest/docksal.md)
+* [5 minutes setup](https://andock-ci-pipeline.readthedocs.io/en/latest/getting-started/docksal.md)

docs/configuration/build.md

@@ -1,2 +1,39 @@
 # Build configuration 
-@TODO
+The build steps are configured in 
+* `.andock-ci/hooks/build_tasks.yml`
+
+### Sample build_tasks.yml
+```yaml
+- name: Composer
+  command: "composer install"
+  args:
+    chdir: "{{ checkout_path }}"
+- name: npm install
+  command: "npm install"
+  args:
+    chdir: "{{ checkout_path }}/docroot/themes/custom/theme"
+- name: Compile scss
+  command: "npm run compile"
+  args:
+    chdir: "{{ checkout_path }}/docroot/themes/custom/theme"
+
+```
+### .gitignore
+To commit builded artifacts the folders must be removed from .gitignore.
+To easily manage this you can use ansible file blocks.
+```
+#### BEGIN REMOVE ANDOCK-CI ###
+Folders  
+#### END REMOVE ANDOCK-CI ###
+```
+#### Sample:
+```
+#### BEGIN REMOVE ANDOCK-CI ###
+docroot/core
+docroot/modules/contrib
+docroot/themes/contrib
+docroot/profiles/contrib
+vendor
+#### END REMOVE ANDOCK-CI ###
+
+```

docs/configuration/overview.md

@@ -1,2 +1,10 @@
-# Configuration overview 
-@TODO
+# Configuration  
+The following configuration files are added to a project by running `fin acp generate:config`
+
+| File name                  | Description |
+|----------------------------|:------------|
+| `andock-ci.yml`            | Main configuration file.  
+| `hooks/build_tasks.yml`    | Build hook fired while `fin acp build`. |
+| `hooks/init_tasks.yml`     | Build hook fired while `fin acp fin init` |
+| `hooks/update_tasks.yml`   | Build hook fired while `fin acp fin update`|
+| `hooks/test_tasks.yml`     | Build hook fired while `fin acp fin test`|

docs/getting-started/build.md

@@ -1,10 +1,8 @@
 # Build your project.  
-Why should you build your project first?
-The build process is made for a scenario where your production site is hosted on acquia etc.
-@TODO
+The build process is configured through the 
 
 ### Sample build_tasks.yml
-```
+```yaml
 - name: Init andock-ci environment
   command: "composer install"
   args:

docs/getting-started/the-software.md

@@ -1,14 +1,23 @@
-# What is andock.
-andock is a set of ansible roles to manage the complete build and deploy life cycle. and a command line tool to manage these ansible roles.
+# Concept overview.
+andock is a set of ansible roles to manage the complete build and deploy life cycle and a command line tool to manage these ansible roles.
 
-## Life cycle
-* build
-* unit tests
+## Pipeline steps:
+* build (unit tests, deploy to deployment branch)
 * Environment creation/updates
 * QA tests 
 * Environment removal
 
 ## Ansible roles
 * server
 * build
-* fin
+* fin
+
+### Role: server
+Manages docksal installations and updates. 
+
+### Role: build
+Build project and deploy the artifact to a target repository. Right now only git repositories are supported but in future other deploy strategy should supported.
+This runs typically on CI server. [See configuration](build.md)
+
+### Role: fin
+Checks out the deployed artifact and run fin up. [See configuration](fin.md)

docs/index.md

@@ -1,29 +1,7 @@
 # andock(ci) - docksal and ansible powered hosting.
 
 ## What is andock?
-A docksal hosting solution.
-
-## What is andock pipeline?
-A command line tool for andock.   
-
-## For what can you use andock?
-* Host your project including environments support for every branch.
-* Host your project on acquia, platform.sh etc. Use andock for unlimited development environment.
-* Use andock to host review environments for qa suites. 
-## Do I need a ci server?
-No the easiest way is to use as a docksal addon. For further automation an CI is recommend. @TODO
-## How can I use andock
-* As docksal addon
-* As a docker image inside your CI
-* As a standalone command line tool.
-## Key features
-* Easy to use command line tool.
-* Use ansible to remote control docksal.
-* Easy configuration.
-* One environment per branch.
-* Extendable with init, update, tests ansible hooks.
-* drush support including drush sql-sync without extra ssh container.
-* Easy to integrate in your CI environment.
+A docksal hosting solution.<br>
 
 
 ## Getting started:

mkdocs.yml

@@ -1,4 +1,4 @@
-site_name: andock-ci pipeline Documentation
+site_name: andock(ci) pipeline documentation
 theme: readthedocs
 repo_url: https://github.com/andock-ci/pipeline
 site_url: https://docs.andock-ci
@@ -7,14 +7,14 @@ markdown_extensions:
 pages:
   - Home: index.md
   - Getting started:
-    - What is andock: getting-started/the-software.md
+    - Concept overview: getting-started/the-software.md
     - System requirements: getting-started/system-requirements.md
     - 5 minutes setup: getting-started/docksal.md
     - Automate on your ci: getting-started/ci.md
   - Configuration:
     - Overview: configuration/overview.md
-    - Hook configurations:
-      - Drupal: configuration/example-drupal-hooks.md
     - Build configuration: configuration/build.md
+      - Hook configurations:
+        - Drupal: configuration/example-drupal-hooks.md
     - Fin configuration: configuration/fin.md
     - Server configuration: configuration/fin.md