Add debugging / troubleshooting documentation section

[devlead]

With Cake PR cake-build/cake#858 merged debugging support was added to Cake. When released we should update docs with a new Troubleshooting section with atleast 2 pages

• debugging
  • parameter, howto etc.
• logging & analytics
  • how to log and debug in a way that helps you when running on CI etc.

[pascalberger]

@devlead What do you think about adding the content of this and this blog post to the proper Editor section?

[gep13]

@pascalberger I have it on my list to do exactly that, but simply haven't had the time. Having the information in blog posts is great, but I do feel that we should add it to the docs section as well.

[pascalberger]

For 2.0 we should add documentation how to debug by manually attaching debugger