added more details and improved formatting.

yet another draft. Thoughts