Iterate example doesn't include iterate method about docs HOT 3 CLOSED

The example is truly broken forever, and so is the iterate method (both added in January 2013):

arangodb/arangodb@9c87607#diff-4f14e2f5e1736e5f8bf3770cc8016435ce6f00e72a71b895cb8dba2ff5b60c99R206-R292

• The example uses the map method instead of showing how to use the iterate method
• The logic for probability is flawed. Higher values make it less likely to pick a document unless the probability is >= 1.0
• Any calls of the method with a probability < 1.0 result in an error because db is undefined. It seems like require("@arangodb").db isn't available in common modules

from docs.

After checking with Jan, iterate() will be deprecated from 3.11 onwards and potentially be removed in 4.0 because it's hardly useful and only works with small collections (it loads the entire collection content).

from docs.

Documentation updates added to #1144

from docs.