start to Githubify the docs

it still contains many (broken) links
 to internal resources and mediawiki pages