completed the README.md file of the different construction methodologies and clarified some of the constructors in the code
did the pandoc from markdown to rst and updated the sphinx build