Adds design/implementation notes
tweaks notes