doc: updates formatting to markdown-svnwiki

- using special procedure syntax
- using only one h1 line (toc is added so we just want 1 of them)
- minor other improvements
build: adds project synopsis/description

for the egg index