doc,test: improvements and cleanup for assert.snapshot()

General improvements and cleanup of the docs and tests recently added for assert.snapshot().

Side note: it feels pretty unfortunate that assert.snapshot() returns a Promise, but that is not changed here.