serious reworking of documents

* added sev 2 and 3 examples
* refacored a number of statements out of the main overview
	and into specific severity level descriptions.