На сколько корректно использовать фасад для команд?

Question

[dmitriy]

Для реализации сценариев Application Layer использую команды и хендлеры,

$commandBus->handle( new LoadFileFromSource($loadParamDto));

и все бы хорошо но, есть некая проблема в использовании, скажем так нет удобства в документировании, когда подключаешь сервис и видишь публичые методы, в данном случае приходится открывать документацию (wiki) или каталог с исходниками чтобы увидеть весь перечень команд и обработчиков.
Поэтому пришел к реализации классов- фасадов в каждом логическом пакете, который предоставляет АПИ к командам пакета.
$fileFacade->loadFileFromSource($loadParamDto);

Хотелось бы узнать как документируете команды, события в ваших системах, на сколько кошерно использовать фасад?