doc: add information about Assert behavior and maintenance
authorRich Trott <rtrott@gmail.com>
Mon, 12 Oct 2015 20:58:00 +0000 (13:58 -0700)
committerJames M Snell <jasnell@gmail.com>
Thu, 29 Oct 2015 15:38:40 +0000 (08:38 -0700)
commit23a1140ddb3f83941b402e11db293a42389db273
tree2b5f93dc3a63002b1ba59e3690755df71cfc264e
parent0427cdf0943c5bfea4a783d27dd4d0862370c5f0
doc: add information about Assert behavior and maintenance

Assert is now locked. Userland alternatives should be used. Assert is
for testing Node.js itself.

Document potentially surprising use of enumerable properties only in
deep equality assertions.

Ref: https://github.com/nodejs/node/pull/3124
Ref: https://github.com/nodejs/node/issues/3122

PR-URL: https://github.com/nodejs/node/pull/3330
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Fedor Indutny <fedor@indutny.com>
Reviewed-By: Rod Vagg <rod@vagg.org>
doc/api/assert.markdown