update README for github and split it up into docs/