README.md in u3d-1.0.4 vs README.md in u3d-1.0.5

@@ -1,15 +1,16 @@
-U3D
-###
+# U3D
 
 [![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/DragonBox/u3d/blob/master/LICENSE)
 [![Gem](https://img.shields.io/gem/v/u3d.svg?style=flat)](https://rubygems.org/gems/u3d)
 [![Build Status](https://img.shields.io/circleci/project/DragonBox/u3d/master.svg?style=flat)](https://circleci.com/gh/DragonBox/u3d)
 [![Coverage Status](https://coveralls.io/repos/github/DragonBox/u3d/badge.svg?branch=master)](https://coveralls.io/github/DragonBox/u3d?branch=master)
 
 U3d is a set of tools to interact with Unity3D from command line. It is available on Linux, Macintosh and Windows.
 
+---
+
 ## What can it do?
 
 U3d provides help for running and installing unity from CLI.
 
 U3d knows about your Unity project and behaves differently if invoked from within a Unity project directory. For example, it can run or download the version required by your project without you having to specify it.
@@ -137,10 +138,26 @@
 u3d run -r
 ```
 
 You can get further information on how to use U3d by running `u3d --help` (or `u3d -h`).
 
-## SSL Error
+## How-tos
+
+### Reuse u3d install on a CI environment
+
+Here you have multiple options
+
+* pass the password using `U3D_PASSWORD` environment variable
+
+* if on Mac, use the keychain option (you set it before hand on the machine, e.g. from the command line using `u3d credentials` add (use `u3d credentials check` to verify) and then use `u3d install -k` to activate the keychain while installing.
+
+### Troubleshoot
+
+Use the global `--verbose` argument to enable debug logs.
+
+Use the global `-t` argument to display stack traces if a crash occurs.
+
+### Solve SSL Errors
 
 If you face an issue similar to this one
 
 ```shell
 SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed