Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

docs(readme): declare root configs as fleet canonical#47

Merged
rubenvdlinde merged 1 commit into
developmentfrom
chore/canonical-root-configs
May 21, 2026
Merged

docs(readme): declare root configs as fleet canonical#47
rubenvdlinde merged 1 commit into
developmentfrom
chore/canonical-root-configs

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Summary

  • Adds a callout to the README declaring phpcs.xml, phpmd.xml, psalm.xml, phpstan.neon, and phpstan-bootstrap.php as the fleet canonical for all Conduction PHP apps.
  • Sets the expectation: per-app deviations live in baselines (phpstan-baseline.neon, psalm-baseline.xml), not in the canonical files themselves.
  • Unblocks a template-sync flow that propagates these configs from here to all 17 PHP apps in apps-extra/.

Context

Recon across the fleet (17 PHP apps) showed effectively zero shared quality config — every app drifted its own copy of phpcs.xml etc. The nextcloud-app-template root configs already match the newest-scaffolded apps (deskdesk byte-for-byte for phpcs.xml; 4-way hash match for phpstan.neon across template + deskdesk + planix + shillinq). This PR formalises that the template IS the canonical surface — no file changes to the configs themselves, just the convention statement.

Phase 0 of a fleetwide consolidation. Follow-ups will (a) clean drift outliers across the 17 apps, (b) pilot the sync on deskdesk, (c) fan out fleet-wide, (d) wire up a repo-file-sync workflow here so future canonical changes auto-PR across the fleet.

Test plan

  • README renders correctly (markdown blockquote, no broken refs)
  • No code changes — nothing else to test

phpcs.xml, phpmd.xml, psalm.xml, phpstan.neon, and phpstan-bootstrap.php
in this repo are the source of truth for the Conduction PHP fleet. Apps
mirror these files; per-app deviations belong in baselines, not in the
canonical files themselves.

This unblocks a fleetwide template-sync flow that propagates root-config
changes from here to all 17 PHP apps in apps-extra/.
@rubenvdlinde rubenvdlinde requested a review from Rem-Dam as a code owner May 21, 2026 18:38
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/nextcloud-app-template @ 47f9087

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
composer ✅ 100/100
npm ❌ 2/684 denied
PHPUnit ⏭️
Newman ⏭️
Playwright ⏭️

❌ Denied npm licenses

Package Version License
pako 1.0.11 (MIT AND Zlib)
sha.js 2.4.12 (MIT AND BSD-3-Clause)

Quality workflow — 2026-05-21 18:39 UTC

Download the full PDF report from the workflow artifacts.

@rubenvdlinde rubenvdlinde merged commit 088a553 into development May 21, 2026
15 of 22 checks passed
@rubenvdlinde rubenvdlinde deleted the chore/canonical-root-configs branch May 21, 2026 18:39
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant