docs: improve docs & parameter descriptions

[lili2311]

• [ ] Tests written and linted ℹ︎
• [x] Documentation written ℹ︎
• [x] Commit history is tidy ℹ︎

What this does

Update parameter descriptions & docs to link to existing Snyk docs where possible

[aarlaud]

:tada: This PR is included in version 1.7.0 :tada:

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot :package::rocket: