rename design.md to README.md and a few updates