Рассмотрите вариант использования тайпхинтинга (объявления типов) вместо doc-блоков