Note that design is outdated
Fix documentation typos