ERROR | Missing member variable doc comment (moodle.Commenting.VariableComment.Missing) reporting on constructor parameters.
gjb2048 opened this issue · comments
In https://github.com/moodlehq/moodle-cs/releases/tag/v3.4.2 the sniff "Add new moodle.Commenting.VariableComment sniff to check that the @var tag and its types are used correctly." was added. This appears to be incorrectly reporting an issue with constructor parameters:
given the line numbers, you can match against https://github.com/gjbarnard/moodle-theme_foundation/blob/MOODLE_403/classes/admin_setting_configcolourpicker.php#L32-L60 being the code:
No matter what I do to the documentation comments of the actual member variables, I can't solve this! Do I need to add some sort of reference to the inherited member variables?
If you'd like a core file to test against, then use the lib/adminlib.php file:
being the code:
in Moodle 2023100903.11 4.3.3+ (Build: 20240326).
I realise that this is Windows, however, first spotted GitHub actions given moodlehq/moodle-plugin-ci@c3f7ea8#diff-d2ab9925cad7eac58e0ff4cc0d251a937ecf49e4b6bf57f8b95aab76648a9d34R58.