Replace README.md with CONTRIBUTING.md, for consistency with other projects

Marco Cattaneorequested to merge
updateDoc into master

@erodrigu @pkoppenb @rmatev FYI. The update contains also an explanation for the various maintained branches

Merge request reports