Skip to content

Docs/Authorities: restructure maintenance.md as single source of truth - #11982

Merged
mbecker-databay merged 1 commit into
ILIAS-eLearning:trunkfrom
marvimarv:docs/maintenance-md-single-source
Aug 25, 2026
Merged

Docs/Authorities: restructure maintenance.md as single source of truth#11982
mbecker-databay merged 1 commit into
ILIAS-eLearning:trunkfrom
marvimarv:docs/maintenance-md-single-source

Conversation

@marvimarv

Copy link
Copy Markdown

Summary

This PR restructures docs/development/maintenance.md and makes it the single source of truth for component maintainerships, replacing the per-component maintenance.json files.

  • Components are listed alphabetically by their folder name in components/ILIAS/, one uniform authority block each, with a GitHub link and the Feature-Wiki assignment (Belongs to); folders grouped under one Feature-Wiki component (Login/Auth & Registration, ECS Interface, Study Programme, …) share their authority data
  • Authority entries use the format [<github-username>](<link-to-docu-profile>), documented in How Authority Assignments are Stored
  • The Tester and Unit-specific Guidelines, Rules, and Regulations fields were dropped (Technical Board decisions, July 2026)
  • All 164 maintenance.json files are removed (163 component folders plus templates/maintenance.json); ilComponentBuildPluginInfoObjectiveTest::testScanDir and the dead maintenance.json links in components/ILIAS/Refinery/docs/CONTRIBUTING.md were adjusted accordingly

All authority changes in this PR were confirmed with the affected maintainers during an outreach round in July/August 2026 (AuthSOAP & OpenIdConnect → mjansen + thojou, Cache/FileDelivery/FileServices → fschmid, soap → minervis, VirusScanner → unmaintained, Html → Security, Init → Initialisation Service, ILIASObject username fix), and all upstream authority commits through afde68d/8af32b1 are included.

Cleanup agreed by the Technical Board: the Cloud and SystemFolder components are removed. Reviewer note: Cloud contained the RemoveCloudDBUpdate setup migration — please confirm all supported update paths have already shipped it.

Follow-ups (handled separately)

  • Multilingualism: Kröpelin Projekte will move the remaining content into Language (~September); the folder is dissolved afterwards
  • KioskMode_: merge into KioskMode is being handled by Kröpelin Projekte
  • BackgroundTasks_: a concept by thojou is under discussion; the folder intentionally stays listed as unmaintained for now (as do Http_ and UI_)
  • Testcase Management will be informed about the changed Curate Test Cases authorities, as required by the rules in this document

For the Technical Board of the ILIAS Association

Restructure docs/development/maintenance.md: components are listed
alphabetically by their folder name in components/ILIAS/, each with
a uniform authority block, and the file replaces the per-component
maintenance.json files as the single source of truth for
maintainership data.

Structural changes:
- one block per component folder with GitHub link and Feature-Wiki
  assignment ("Belongs to"); wiki-grouped folders (Login/Auth,
  ECS Interface, Study Programme, ...) share their authority data
- authority entries use the format
  [<github-username>](<link-to-docu-profile>), documented in
  "How Authority Assignments are Stored"
- "Tester" and "Unit-specific Guidelines, Rules, and Regulations"
  fields dropped (TB decisions, July 2026)
- all 164 maintenance.json files removed (163 component folders
  plus templates/maintenance.json)
- ilComponentBuildPluginInfoObjectiveTest::testScanDir no longer
  expects maintenance.json; dead maintenance.json links in
  components/ILIAS/Refinery/docs/CONTRIBUTING.md now point to the
  maintenance.md

Authority updates agreed with the maintainers (July/August 2026):
- AuthSOAP: Pascal Seeland removed -> mjansen, thojou
- OpenIdConnect: smeyer -> mjansen, thojou
- Cache, FileDelivery, FileServices -> fschmid
- soap -> minervis (githamo, sKarki999; De-Assign: TimoScheuer)
- VirusScanner -> unmaintained (rschenk stepped down)
- Html assigned to Security instead of Forum (component is the
  HTML-Purifier service)
- Init mapped to "Initialisation Service" (mjansen, tfuhrer,
  fschmid) instead of the Login/Auth group
- ILIASObject: username fixed fawinike -> skergomard (usr 44474)
- Feature-Wiki links added for BackgroundTasks, CmiXapi (xAPI),
  ContentPage, FileUpload (File), GlobalScreen, Group,
  IndividualAssessment, Taxonomy

Cleanup (TB decisions):
- Cloud and SystemFolder components removed; note: Cloud contained
  the RemoveCloudDBUpdate setup migration
- Http_, UI_ and BackgroundTasks_ intentionally stay listed as
  unmaintained

For the Technical Board of the ILIAS Association
@marvimarv marvimarv added documentation Pull requests that only update or add documentation. technical board labels Aug 25, 2026
@mbecker-databay
mbecker-databay merged commit 269c1d9 into ILIAS-eLearning:trunk Aug 25, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Pull requests that only update or add documentation. technical board

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants