doc: improve assert.markdown copy

General improvements to assert.markdown copy including
new and improved examples

PR-URL: https://github.com/nodejs/node/pull/4360


Reviewed-By: Trevor Norris <trev.norris@gmail.com>