fixed a bunch of spelling before making real changes/additions. Added a ...

...few comments in intro.
One distinction I am trying to make is that code can be developed in a fashion that meet standards, but to be fully compliant it needs to be documented as well. This paragraph needs some work.