Add docs for DiscoveryService.createDecorator

[micalevisk]

there's no mention about DiscoveryService built-in provider from @nestjs/core

so there's no mention about the feature add in nestjs v10.2.0 nestjs/nest#12107

I'd like to see the DiscoveryService.createDecorator somewhere in the docs like we have for Reflector.createDecorator. Not sure where, tho 🤔

This is to clarify mainly this:

1. we can't use the same decorator more than once for each target class because only the first (top-down order) one will be taken into account

[andreasvh-conceto]

Is there something in progress? It would be absolutely great to have this documented.

Thx :)

[micalevisk]

@andreasvh-conceto I won't work on this soon

Feel free to open a PR to address this