Updated README.md + added code documentation + minor updates on the design file