Added a warning to the design doc that it could be outdated.

- Fixed some parsing errors.