Spin off from #2134513-55: [policy, no patch] Trait strategy → . Since that issue is only making traits for a small subset of controller dependencies, we'll still be left with constructor injection of some dependencies in many controllers. As pointed out in that comment, a separate PHPDoc for each protected variable plus each constructor parameter is both redundant, and also unnecessary entirely given proper type hints, variable names, and an IDE that's capable of autocompleting on static code analysis (e.g., PhpStorm).
Proposal: combine declaration of DI property variables, __construct(), and create() into a single section of code, with only a single, minimal, PHPDoc for the entire combination.
Goal: to reduce the verbosity of implementing DI within controllers, so that it's less intimidating, and distracts less from the actual logic of the controller.
Closed: duplicate
Coding Standards
It involves compliance with, or the content of coding standards. Requires broad community agreement.
Issue summaries save everyone time if they are kept up-to-date. See Update issue summary task instructions.
Not all content is available!
It's likely this issue predates Contrib.social: some issue and comment data are missing.
There are now other issues about removing unnecessary doc lines have been created to work on this is small increments. I've added those as related. For this issue, I think it best to close in deference to the others. I am closing this as a duplicate and transferring credit to #2140961: Allow constructor methods to omit docblocks → which seems the closest fit.