Updated example description.
Added update to assertion section, since pytest has a different style of asserting failures, and prints different output when a failure occurs.
Updated the rest of the document WRT pytest
Proof read and  markup fixes