feat: add support for and document --deep for subresources

[MarshallOfSound]

Adds docs, example and impl for using --deep in the "right" way.

Fixes #240

[continuous-auth[bot]]

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

The release is available on:

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

Your semantic-release bot :package::rocket: