Skip to content

Create Source of Truth document for organization-wide github issue label taxonomy #12

Description

@PrinceAsiedu

Below is a governance-grade issue description that is clear, scoped, and aligned with how mature open source organizations document shared infrastructure.

Issue Description

To support consistent issue management, automation, reporting, and contributor onboarding across OSSAfrica, we need a single, authoritative Source of Truth for our GitHub issue label taxonomy.

This work will define and document a standardized, organization-wide set of GitHub issue labels, including their names, purposes, usage guidelines, and color codes. The goal is to ensure that all OSSAfrica repositories use a shared labeling system that enables clarity, predictability, and scalable collaboration as the organization grows.

This document will also serve as the reference point for:

  • Organization-wide label synchronization
  • GitHub Projects configuration
  • Automation rules (e.g., auto-labeling, workflows, and reporting)
  • Contributor and maintainer guidance

Once established, this taxonomy should be treated as governed infrastructure and updated only through a defined change process.

Scope

  • Define a complete organization-wide label taxonomy
  • Document label categories, meanings, and intended usage
  • Specify standard color codes for each label
  • Identify which labels are mandatory vs optional
  • Provide guidance for automation and future expansion

Deliverables

  • A documented Source of Truth file stored in the appropriate governance or community repository
  • Clear instructions for applying the taxonomy across all OSSAfrica repositories
  • Alignment with current and planned GitHub Projects and

Success Criteria

  • Labels are unambiguous and consistently defined
  • The taxonomy can be applied uniformly across all repositories
  • The document is suitable for maintainers, contributors, and automation tooling
  • Future changes can be proposed and reviewed transparently

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementNew feature or requestgood first issueGood for newcomers

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions