Improve TESTING documentation

Author: zuazo

Diff for: TESTING.md

@@ -1,29 +1,6 @@
 Testing
 =======
 
-## Required Gems
-
-* `yard`
-* `vagrant`
-* `foodcritic`
-* `rubocop`
-* `berkshelf`
-* `simplecov`
-* `should_not`
-* `chefspec`
-* `test-kitchen`
-* `kitchen-vagrant`
-
-### Required Gems for Guard
-
-* `guard`
-* `guard-foodcritic`
-* `guard-rubocop`
-* `guard-rspec`
-* `guard-kitchen`
-
-More info at [Guard Readme](https://github.com/guard/guard#readme).
-
 ## Installing the Requirements
 
 You must have [VirtualBox](https://www.virtualbox.org/) and [Vagrant](http://www.vagrantup.com/) installed.
@@ -35,17 +12,40 @@ You can install gem dependencies with bundler:
 
 ## Generating the Documentation
 
+This will generate the documentation for the source files inside the [*libraries/*](https://github.com/zuazo/ssl_certificate-cookbook/tree/master/libraries) directory.
+
     $ bundle exec rake doc
 
-## Running the Syntax Style Tests
+The documentation is included in the source code itself.
+
+## Syntax Style Tests
+
+We use the following tools to test the code style:
+
+* [RuboCop](https://github.com/bbatsov/rubocop#readme)
+* [foodcritic](http://www.foodcritic.io/)
+
+To run the tests:
 
     $ bundle exec rake style
 
-## Running the Unit Tests
+## Unit Tests
+
+We use [ChefSpec](https://github.com/sethvargo/chefspec#readme) and [RSpec](http://rspec.info/) for the unit tests. RSpec is generally used to test the libraries or some Ruby specific code.
+
+The unit test files are placed in the [*test/unit/*](https://github.com/zuazo/ssl_certificate-cookbook/tree/master/test/unit) directory.
+
+To run the tests:
 
     $ bundle exec rake unit
 
-## Running the Integration Tests
+## Integration Tests
+
+We use [Test Kitchen](http://kitchen.ci/) to run the tests and the tests are written using [Serverspec](http://serverspec.org/).
+
+The integration test files are placed in the [*test/integration/*](https://github.com/zuazo/ssl_certificate-cookbook/tree/master/test/integration) directory. Some cookbooks required by this tests are in the [*test/cookbooks/*](https://github.com/zuazo/ssl_certificate-cookbook/tree/master/test/cookbooks) directory.
+
+To run the tests:
 
     $ bundle exec rake integration:vagrant
 
@@ -55,24 +55,21 @@ Or:
     $ bundle exec kitchen test
     [...]
 
-### Running Integration Tests in Docker
+### Integration Tests in Docker
 
-You need to have [Docker installed](https://docs.docker.com/installation/).
+You can run the integration tests using [Docker](https://www.docker.com/) instead of Vagrant if you prefer.
+
+Of course, you need to have [Docker installed](https://docs.docker.com/engine/installation/).
 
     $ wget -qO- https://get.docker.com/ | sh
 
 Then use the `integration:docker` rake task to run the tests:
 
     $ bundle exec rake integration:docker
 
-### Running Integration Tests in the Cloud
-
-#### Requirements
+### Integration Tests in the Cloud
 
-* `kitchen-digitalocean`
-* `kitchen-ec2`
-
-You can run the tests in the cloud instead of using vagrant. First, you must set the following environment variables:
+You can run the tests in the cloud instead of using Vagrant. First, you must set the following environment variables:
 
 * `AWS_ACCESS_KEY_ID`
 * `AWS_SECRET_ACCESS_KEY`
@@ -85,3 +82,21 @@ You can run the tests in the cloud instead of using vagrant. First, you must set
 Then use the `integration:cloud` rake task to run the tests:
 
     $ bundle exec rake integration:cloud
+
+## Guard
+
+Guard is a tool that runs the tests automatically while you are making changes to the source files.
+
+To run Guard:
+
+    $ guard
+
+More info at [Guard Readme](https://github.com/guard/guard#readme).
+
+## Available Rake Tasks
+
+There are multiple Rake tasks that you can use to run the tests:
+
+    $ rake -T
+
+See [Rakefile documentation](https://github.com/ruby/rake/blob/master/doc/rakefile.rdoc) for more information.