Dutch Drone Squad GitHub defaults

This repository contains shared GitHub configuration for the DutchDroneSquad organization.

The canonical organization label set lives in .github/labels.yml. It defines the shared label names, colors, and descriptions used by Dutch Drone Squad repositories. Labels referenced by Release Drafter, such as breaking-change, new-feature, bugfix, and dependencies, must also be defined in this manifest.

GitHub does not automatically inherit labels from an organization .github repository. Each repository therefore retains its own label synchronization workflow, which reads this manifest from its public raw GitHub URL. These workflows run weekly and can also be started manually. They use the calling repository's GITHUB_TOKEN, so no organization-wide token is required.

Use the following workflow in a repository:

---
name: Sync labels
# yamllint disable-line rule:truthy
on:
 schedule:
 - cron: "17 4 * * 1"
 workflow_dispatch:
permissions:
 contents: read
jobs:
 labels:
 name: ♻️ Sync labels
 runs-on: ubuntu-latest
 permissions:
 issues: write
 steps:
 - name: 🚀 Run Label Blueprint
 uses: klaasnicolaas/action-label-blueprint@v1.0.0
 with:
 labels-file: https://raw.githubusercontent.com/dutchdronesquad/.github/main/.github/labels.yml

Label Blueprint is non-destructive by default, so repositories retain additional local labels that are not part of the shared manifest. Enable prune: true only when a repository must match the central manifest exactly. Labels can include aliases when an existing label should be renamed without losing its issue and pull request assignments.

The default Release Drafter configuration lives in .github/release-drafter.yml. Repositories without a local file at that path automatically use this organization-wide configuration.

The Release Drafter workflow intentionally remains in each repository. This allows repositories to choose their own triggers, permissions, and action version:

---
name: Release Drafter
# yamllint disable-line rule:truthy
on:
 push:
 branches:
 - main
 workflow_dispatch:
concurrency:
 group: release-drafter-${{ github.repository }}-${{ github.ref }}
 cancel-in-progress: true
jobs:
 update_release_draft:
 name: ✏️ Draft release
 runs-on: ubuntu-latest
 permissions:
 contents: write
 pull-requests: read
 steps:
 - name: 🚀 Run Release Drafter
 uses: release-drafter/release-drafter@v7.7.0
 env:
 GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

A repository can override the organization default by adding its own .github/release-drafter.yml.

To keep the shared defaults and only override individual scalar settings, extend the organization configuration:

---
_extends: DutchDroneSquad/.github
name-template: "service-v$RESOLVED_VERSION"
tag-template: "service-v$RESOLVED_VERSION"

List settings such as categories, autolabeler, and replacers are replaced as a whole by default. Release Drafter also supports append and prepend merge strategies, but category order affects matching and exclusivity. Prefer a complete local list when a repository needs substantially different categories.

A repository that intentionally needs fully independent behavior can use a standalone local configuration without _extends.