moved some common documentation into the readme