doc: updates for better json generating

E.g. for tracker.calls([fn][, exact]) from doc/api/assert.md we currently have:

The return.desc doesn't explain return type.

So I made a change:

- * Returns: {Function} that wraps `fn`.
+ * Returns: {Function} A function that wraps `fn`.