mochajs / mocha / 4732

94%

main: 94%

push

travis-ci

docs(lib/mocha.js): Update API documentation (#3515)

### Description of the Change

Replaced all method headers with more complete documentation, better following recommended styles. Eliminated `@api` tags, as `@access` _should_ imply same. Used `@chainable` to denote class methods returning `this` instance.

Renamed a handful of variables, but **no logic changes**!

### Alternate Designs

N/A

### Why should this be in core?

N/A

### Benefits

API documentation will be more useful if more complete.

### Possible Drawbacks

N/A

### Applicable issues

semver-patch

807 of 965 branches covered (83.63%)

11 of 11 new or added lines in 1 file covered. (100.0%)

2001 of 2215 relevant lines covered (90.34%)

420.45 hits per line