Migrate docs to asciidoctor

[mariogarcia]

Things to bear in mind:

About the documentation

• I've copied everything in the README, CONTRIBUTING.md and in the Wiki pages to the asciidoctor pages.
• I've kept the README with an introduction about Lazybones and the reference to the documentation and the contribution guidelines.

About publishing the documentation

• Documentation is meant to be published as gh-pages, that's why I've added the gh-pages plugin. Once they are publish they should be available at pledbrook.github.io/lazybones.
• ghPages will be published executing the command publishGhPages. It only requires to have a github api key stored in your gradle.properties accessible as github.token
• I've modified the templates.gradle to add the condition of the publushGhPages. If you check the verification of the task type, I didn't use the class type because it turns out the task is created on-the-fly so I couln't do 'task instanceof SomeTypeTaskinstead I usedtask.name == 'publishGhPages'`

Problems I found:

I'm unable to pass integration tests. I have cloned a clean version of lazybones without any luck. When I checked the results of the tests it seems they are out-of-date because they're receiving different responses than the ones expected. I've never used betamax so maybe is something I haven't configured properly.

Questions:

At the moment the contribution guidelines is saying any new feature should be documented in the README. Should I change that kind of this now to point at the new documentation ? If so I would add a new commit to wrap all documentation changes from the original copied from the README.

Well, that's pretty much it. Don't worry if it takes you some time, I fully understand :)

[pledbrook]

For future reference, you shouldn't remove this file as GitHub links to it when someone submits a pull request. I'll try to resurrect it locally and push the changes.

[pledbrook]

Thanks for this contribution! It's very much appreciated. I'm currently trying to sync it with a new feature added with another pull request. Once I'm happy with the implementation of the new feature and the user guide, I'll push the changes.

[mariogarcia]

I've just read this. I'll do the changes asap.

[mariogarcia]

Ok, I've recovered CONTRIBUTING.md from the master branch I had, before creating this one.