added main documentation file
minor reformatting
shell highlighting