project-administration

This repository is the Control Plane for CAMARA project administration. It hosts project-wide automation that operates across the CAMARA repository landscape.

Maintained under the supervision of TSC and the Release Management working group.

• CAMARA Governance: https://github.com/camaraproject/Governance
• Release Management repository: https://github.com/camaraproject/ReleaseManagement

Purpose

This repository provides:

• Project-wide campaigns for coordinated changes across repositories
• Long-lived project support systems (e.g. Release Collector)
• Orchestration workflows for administrative tasks
• Authoritative project-level data (e.g. collected release metadata, api-landscape config input)
• Derived reports and interactive viewers (e.g. meta-release tables)

Scope

Belongs here:

• Project-wide campaigns
• Long-lived project support systems
• Orchestration workflows
• Authoritative project-level data
• Derived, regenerable reports

Does not belong here:

• Reusable CI workflows for API repositories (see tooling)
• Shared actions or generic tooling

Current Content

Release Collector

Automated collection and tracking of CAMARA API releases.

• Location: workflows/release-collector/
• Features: Daily automated check for updates, creation of releases-master.yaml, data enrichment for reports, interactive HTML viewers for meta-releases (Fall24, Spring25, Fall25) and complete API portfolio. Manual deployment to production website with separate workflow.
• Documentation: workflows/release-collector/docs/README.md
• Workflows: release-collector.yml, release-collector-production.yml

Release Collector Configuration

Configuration files used by the Release Collector (at repository root level):

• API Landscape: config/api-landscape.yaml - Portfolio metadata (categories, URLs, tooltips) for API enrichment
• Meta-Release Mappings: config/meta-release-mappings.yaml - Maps repository release cycles (r1, r2, r3) to meta-releases (Fall24, Spring25, Fall25)

Release Collector Outputs

Generated and maintained by the Release Collector system:

• Data: data/releases-master.yaml - Master release metadata for all CAMARA API releases
• Reports: reports/ - JSON files (all-releases, fall24, spring25, fall25)
• Viewers: Interactive HTML viewers are not committed, but deployed for review in staging to https://camaraproject.github.io/project-administration/. Deployment to production website manually triggered with release-collector-production.yml.

Campaigns

Goal-oriented, time-bound initiatives for coordinated changes across repositories (with idempotent execution and dry-run feature)

• Location: campaigns/
• Available campaigns:
  • release-info/ - Updates "Release Information" sections in API repository READMEs
  • api-version-wip-check/ - Verifies wip versions in API files after releases
• Workflows: campaign-release-info.yml, campaign-api-version-wip-check.yml

API Repository Creation

Automates setup of new API repositories from Template_API_Repository.

• Location: workflows/api-repository-creation/
• Documentation: workflows/api-repository-creation/docs/README.md
• Workflow: admin-api-repository-creation.yml
• Requirements: Environment repository-creation with GH_REPO_CREATE_TOKEN

Legacy Reporting (to be replaced)

• Workflow: report-repository-overview.yml - Repository overview reporting (legacy, will be replaced)

Reusable Actions

Supporting GitHub Actions for campaigns and workflows.

• Location: actions/
• Actions: render-mustache, replace-delimited-content, ensure-delimited-section, campaign-finalize-per-repo, and others

Repository Structure

project-administration/
├── .github/workflows/           # Workflow entry points
├── actions/                     # Reusable GitHub Actions for campaigns
├── campaigns/                   # Goal-oriented initiatives
│   ├── api-version-wip-check/   # API version compliance checks
│   └── release-info/            # README release info updates
├── config/                      # Shared configuration files
│   ├── api-landscape.yaml       # API portfolio metadata
│   └── meta-release-mappings.yaml
├── data/                        # Release Collector outputs (master data)
│   └── releases-master.yaml     # Master release metadata
├── reports/                     # Release Collector outputs (JSON reports)
└── workflows/
    ├── api-repository-creation/ # Repository creation system
    │   └── docs/README.md
    └── release-collector/       # Release tracking system
        ├── docs/                # Documentation
        ├── schemas/             # YAML schemas
        ├── scripts/             # Processing scripts
        └── templates/           # HTML/viewer templates

Release Information

This repository has no regular release schedule. Workflows are continuously updated based on current needs:

• Tested versions are in the main branch
• Versions under test are in other branches or individual forks

Contributing

Maintained by Release Management WG / TSC.

• Issues and PRs are discussed in Release Management working group meetings
• Larger changes impacting multiple repositories are discussed in the Governance repository and approved by TSC

Contact:

• Admin team: adm@lists.camaraproject.org
• Release Management WG: release-management@lists.camaraproject.org