.github — Backblaze Labs organization defaults

Organization-wide GitHub configuration and shared standards for the Backblaze Labs org.

Contents

Path	What it is
profile/README.md	The org profile shown at github.com/backblaze-labs.
schemas/	Shared, versioned data contracts used across repos.
scripts/	Tooling that validates those contracts.

References standard

Each repo records its external references — blogs, press, docs, videos, directory/registry listings, related projects — in a single machine-parseable references.yml at its root, validated against schemas/references.schema.json. Internal tooling (Quality Keeper, dashboards) reads that one shape across every repo. See schemas/README.md for the full field reference and adoption steps.

Point a repo's references.yml at the schema with a first-line comment:

# yaml-language-server: $schema=https://raw.githubusercontent.com/backblaze-labs/.github/main/schemas/references.schema.json

Validate locally

npm ci
npm run validate           # validates every references*.yml in the repo
npm run validate -- path/to/references.yml   # or a specific file

CI (validate-schema.yml) runs the same check on every push and pull request.