Problem/Motivation
Reduce the time to approve a change.
I don't recall any of the blog posts created since the committee was restarted resulting in comments. I may be wrong but it certainly is not many commenters. It requires time and resource to create the post and it adds two weeks to the approval process. Let's skip that when the change is not disruptive to core and contrib or otherwise controversial.
Benefits
Resolving some coding standards issues at a faster pace.
Three supporters required
- https://www.drupal.org/u/borisson_ (2025-05-30)
- https://www.drupal.org/u/dww (2026-03-03)
- https://www.drupal.org/u/longwave (2026-03-04)
Proposed changes
Provide all proposed changes to the Drupal Coding standards. Give a link to each section that will be changed, and show the current text and proposed text as in the following layout:
1. Coding standards project page, process section
Current text
The Process for Changing Coding Standards
5. If the committee agrees to the change it is tagged "Needs announcement for final discussion". It should be announced the following week on https://www.drupal.org/about/core with a consideration period of at least 14 days. If there are concerns or conversation is ongoing, the issue consultation time may be extended. If the committee does not agree to the change the status may be set to "Won't fix" or to "Needs work".
Proposed text
The Process for Changing Coding Standards
5. If the committee agrees to the change it is tagged "Needs announcement for final discussion". If the change is disruptive or controversial it should be announced the following week on https://www.drupal.org/about/core with a consideration period of at least 14 days. If there are concerns or conversation is ongoing, the issue consultation time may be extended. If the committee does not agree to the change the status may be set to "Won't fix" or to "Needs work".
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
quietone commentedAdded "disruptive or controverisial" so that the blog is not required for every issue. Disruptive is a well used term in Drupal and is defined at
disruptive changes.
Comment #3
borisson_Comment #4
catchVery +1 to this will save a lot of overhead.
Comment #5
dwwThanks for opening this! Adding myself as a supporter in general. Agreed that most of the time, the blog step is extra work for no benefit.
One very minor nit is that linking to https://www.drupal.org/about/core/policies/core-change-policies/allowed-... is somewhat unhelpful for coding style changes, since the definition there is:
The first two points don't make any sense for coding standards, and the last point is a circular definition (basically "disruptive changes means disruptive changes"). I'd drop the link, since it doesn't add any value in this context IMHO.
That said, it wouldn't hurt to be a little more specific for the criteria that the CS committee will use to decide if something is "disruptive". 😅 Not entirely sure if we should add that to the process docs directly, or what.
Here's some brainstorming about it:
Generally, I'd say new standards about new language features we haven't started widely using would be not disruptive. Or changes to standards to be more permissive than we already are (e.g. "no longer require ...") aren't disruptive, since they allow even more code to be compliant. No one *has* to adopt these new standards and change their existing code, so it's not disruptive.
So here are some possible definitions of a "disruptive" coding standard that would trigger a blog post:
We should pick one of these (or something else), I'm not saying all these criteria need to be met. They're sort of different ways of trying to phrase the same basic idea. If anyone has a more concise and accurate definition, please suggest alternatives / improvements. I'm not attached to any of this.
Thanks again!
-Derek
Comment #6
longwave+1 - I am not sure there is enough interest outside of our small group to warrant the time taken here. Most real world projects I work on have their own ruleset based on Coder with a small number of tweaks; so far any changes haven't caused any significant impact that I recall.
I think we should leave the definition of "disruptive" open to the individual case, I'm not sure we can plan in advance all types of things that might be disruptive.
Comment #7
dwwYeah, I'm cool with not formally documenting what counts as "disruptive", and leaving that to the discretion of the committee case-by-case. But I wanted to at least start the conversation so we have some sense of what we actually mean. 😅
I think things like requiring use statements be sorted alphabetically would be "disruptive", since when coder preemptively made that change and rolled it out, all of a sudden a ton of contrib projects started getting failing phpcs jobs. That's the sort of thing we should be wary of.
Comment #8
quietone commentedThis went to the last meeting, #3576923: Coding Standards Meeting Wednesday 2026-03-04 0700 UTC, where there was no further discussion. Therefor changing status and I will make the necessary edits.
Comment #9
quietone commentedI've updated the project page. I think the text could be improved but that can be done later as this has agreed in principle to limiting when a blog is necessary.
Comment #10
borisson_I think this is good as it is now. I think we can close this issue as it is now done.
Comment #11
dwwLooks good, thanks y'all.