Minor fixes in decorators documentation

Fixes rebased on the `develop` branch now.