Groups Initiative

The Groups Initiative is rebuilding Drupal.org’s community Groups platform on Modern Drupal. This site is the working home for the team — the plan, the workstreams, meeting notes, and how to contribute.

Overview

Getting StartedA quick orientation to the Groups Initiative — what it is, where things live, and how the docs and workflow fit together.

TeamWho's on the Groups Initiative.

Key Links & ResourcesThe main project links and resources.

Project

Development ApproachDecisions from the June 30 dev meeting.

Decisions (ADRs)Index of the project's Architecture Decision Records (ADRs), generated at build time from docs/decisions/.

AI PipelineThe three review-rigor pipeline variants, brokered by LiteLLM — names only; the dedicated pages have the details.

MVP ScopeThe 15 MVP issues.

Build SequencingBuild order across four waves.

Issue AssignmentsWho's working on what, plus wireframes.

Drupal Framework

Drupal 11.x & Preparing for 12Platform features worth leaning on in Drupal 11.4, and what to avoid so the Drupal 12.0 upgrade stays smooth.

Workstreams

EventsProgress on the Community Events workstream — feature parity with D7, design and theming status, and the path toward Groups integration.

MatrixStatus of the Matrix integration workstream — the registered modules, the demo site, and current test status.

Meeting NotesTeam sync agendas, decisions, and next steps with owners.

Develop

Developer SetupClone the project, install the docs toolchain, enable the Git hooks, and start contributing.

Contribution StandardsThe source of truth for how we contribute — shared issue forks, branches, merge requests, Conventional-Commit titles, and the human/AI policy.

AI Agent SkillsHow this module ships reusable skills for AI coding agents — where they live, that they ship with the module, and how to add one.

Coding PipelineThe vendored playbook/ — a de-branded, test-first coding-pipeline process framework plus Drupal guidance, kept in-repo for contributors and their AI agents.

Running the PipelineHow to run the coding pipeline in this repo — you brief an AI agent in plain language, it recommends a review-rigor variant and waits for your go-ahead, then drives the phased pipeline and calls the outside-review tooling itself at the gates.

Issue Labels & WorkflowHow Drupal.org scoped issue labels work — category, priority, component, and the state label that carries workflow status.

GitLab Operations & PermissionsWhat works via SSH, the API, glab, and the UI — and what needs maintainer access.

Docs

Editing These DocsHow to run this documentation site locally and add or edit pages.

Choosing a Page (File) FormatWhen to use .md, .mdoc, or .mdx for a docs page, with pros and cons.

Linking Between PagesHow internal and relative links work in these docs — the rules for linking to .md, .mdx, and .mdoc pages, plus the strict validation that keeps broken links from shipping.

Adding Components to Your PagesThe Markdoc tags available in docs pages, and how to use them.

Content TokensShared values (like the tagline) defined once and reused across the site so they stay in sync.

Link Health ReportAutomated external-link check for the docs (lychee).

D11 Migration

Start HereOrientation for the Drupal 6 to Drupal 11 Groups migration documentation.

Conversion PlanFeature-by-feature plan for rebuilding Groups on standard Drupal 11.

Architecture DifferencesArchitecture deltas from the Open Social baseline to standard Drupal 11.

RunbookStep-by-step build runbook for the Drupal 11 Groups rebuild.

Views & EndpointsLegacy Views mapped to Drupal 11 Views and JSON:API endpoints.

Testing StrategyTesting approach for the Groups Drupal 11 conversion.

Appendix

Pipeline VerificationA worked proof that the coding pipeline's review gates catch real defects — a planted-defect differential test at both gates — plus live validation that the Critic engine works across OpenAI, Anthropic, DeepSeek, and local Ollama models.

GitLab MigrationWhat has moved to GitLab and what's still open.