Document service collector tags and the service_collector tag

Created on 25 January 2015, over 10 years ago
Updated 2 June 2025, 4 days ago

Follow-up to #2264047: [meta] Document service definition tags β†’

Problem/Motivation

We are documenting service tags. In this issue, document the service_collector tags and the service_collector tag itself. Here is an example of a service collector tag:

module_installer:
    class: Drupal\Core\Extension\ModuleInstaller
    tags:
      - { name: service_collector, tag: 'module_install.uninstall_validator', call: addUninstallValidator }

The concept of a service_collector is explained in TaggedHandlersPass. Note that service_collector also needs documenting as a tag, because it is a tag.

Proposed resolution

Use @service_tag to document the service_collector tags. See #2264047: [meta] Document service definition tags β†’ .

service_collector could be documented in TaggedHandlersPass. Follow the guidelines in the parent issue on where to document the rest.

The current list of service collector tags is:

  • non_lazy_route_enhancer
  • non_lazy_route_filter
  • twig.loader
πŸ“Œ Task
Status

Postponed: needs info

Version

11.0 πŸ”₯

Component

documentation

Created by

Live updates comments and jobs are added and updated live.
  • stale-issue-cleanup

    To track issues in the developing policy for closing stale issues, [Policy, no patch] closing older issues

Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • πŸ‡ΊπŸ‡ΈUnited States smustgrave

    Thank you for creating this issue to improve Drupal.

    We are working to decide if this task is still relevant to a currently supported version of Drupal. There hasn't been any discussion here for over 8 years which suggests that this has either been implemented or is no longer relevant. Your thoughts on this will allow a decision to be made.

    Since we need more information to move forward with this issue, the status is now Postponed (maintainer needs more info). If we don't receive additional information to help with the issue, it may be closed after three months.

    Thanks!

  • πŸ‡¬πŸ‡§United Kingdom joachim
  • πŸ‡¨πŸ‡¦Canada Charlie ChX Negyesi 🍁Canada

    There hasn't been any discussion here for over 8 years which suggests that this has either been implemented or is no longer relevant.

    No, it suggests people are writing documentation to satisfy a completely outdated policy enforced by automated tools instead of trying to help fellow developers. FieldTypeCategoryInterface gets committed with a comment "Provides an object that returns the category info about the field type." and AuthenticationProviderInterface has "Interface for authentication providers." and I updated #2745947: Adopt a method of documenting service tags β†’ which this issue is postponed upon back in 2023 but absolutely nothing happened. There's no documentation team leader for so many years because, as I said, no one cares one whit about documentation any more aside from bloating core and putting up yet another barrier to core contribution by demanding "documentation" on everything.

  • πŸ‡ΊπŸ‡ΈUnited States smustgrave

    Leaving for stats

Production build 0.71.5 2024