[docs] Add a table of contents to DebuggingTheCompiler.md and re-organize slightly the layout to make things clearer.

I also improved some titles.

Author: gottesmm