Updates to the docs, added examples
Overhaul of the diagnostics page