Problem/Motivation
In #3468236: Adopt phpstan phpdoc types as canonical reference of allowed types we changed the docs for what a valid param type is.
In that process some examples were removed. Evaluate if we need to add some back.
Benefits
Better coding standards docs.
Three supporters required
Proposed changes
Review #3468236: Adopt phpstan phpdoc types as canonical reference of allowed types and evaluate if new examples need to be added to data types in documentation
Remaining tasks
Create this issue in the Coding Standards queue, using the defined template- Add supporters
- Create a Change Record
- Review by the Coding Standards Committee
- Coding Standards Committee takes action as required
- Discussed by the Core Committer Committee, if it impacts Drupal Core
- Final review by Coding Standards Committee
- Documentation updates
- Edit all pages
- Publish change record
- Remove 'Needs documentation edits' tag
- If applicable, create follow-up issues for PHPCS rules/sniffs changes
For a full explanation of these steps see the Coding Standards project page
Comments
Comment #2
xjmI think something we especially need to add guidance like:
...and showing a preference about quoting the associative keys would be nice.