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

  1. https://www.drupal.org/u/borisson_ (2025-05-30)
  2. https://www.drupal.org/u/dww (2026-03-03)
  3. 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

  1. Create this issue in the Coding Standards queue, using the defined template
  2. Add supporters
  3. Create a Change Record
  4. Review by the Coding Standards Committee
  5. Coding Standards Committee takes action as required
  6. Discussed by the Core Committer Committee, if it impacts Drupal Core
  7. Final review by Coding Standards Committee
  8. Documentation updates
    1. Edit all pages
    2. Publish change record
    3. Remove 'Needs documentation edits' tag
  9. 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

quietone created an issue. See original summary.

quietone’s picture

Issue summary: View changes
Status: Active » Needs review

Added "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.

borisson_’s picture

Issue summary: View changes
catch’s picture

Very +1 to this will save a lot of overhead.

dww’s picture

Issue summary: View changes

Thanks 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:

High-risk and disruptive changes

  • changes requiring an upgrade path
  • changes that risk regressions
  • other disruptive bug fixes or high-risk changes

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:

  1. Would cause existing phpcs jobs that currently pass to start failing.
  2. Would require more than 100 (?) lines of change to the existing Drupal Core codebase to be in compliance.
  3. Changes an already agreed standard to to be more specific and would likely require changes to Drupal Core and many (TBD) contributed projects.

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

longwave’s picture

Issue summary: View changes

+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.

dww’s picture

Yeah, 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.

quietone’s picture

Status: Needs review » Reviewed & tested by the community

This 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.

quietone’s picture

I'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.

borisson_’s picture

I think this is good as it is now. I think we can close this issue as it is now done.

dww’s picture

Status: Reviewed & tested by the community » Fixed

Looks good, thanks y'all.

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.