added docs for debugging and included an index.md