Missing guidelines for publishing and broken documentation

[gandhiano]

README.md is still pointing to the original @keikreutler repository and the instructions seem to be incomplete. They are at least unclear to me and despite my merge into source (is it the repo where one should merge?), there is nothing changing on the main page.

[almereyda]

This is related to https://github.com/keikreutler/transformap/issues/1

[almereyda]

The hanging issue at the source repository of this just links to an examplatory README template. We could use it to refine the current one, also in conformance with the structure from the api README.

[almereyda]

The publishing workflow circulates around the combination of GitHub pages in combination with DocPad. Both compartiments may want to be described in the documentation, too.