Skip to content

Add new repository checklist - #93

Merged
Christdej merged 1 commit into
equinor:mainfrom
Christdej:docs/new-repo-checklist
Aug 18, 2026
Merged

Add new repository checklist#93
Christdej merged 1 commit into
equinor:mainfrom
Christdej:docs/new-repo-checklist

Conversation

@Christdej

Copy link
Copy Markdown
Contributor

Summary

Adds docs/new_repo_checklist.md — a codification of the repository settings, rulesets, environments, secrets, variables, and labels currently used across sara-, flotilla, and isar- service repos.

Intended to be followed after creating a new service repo from equinor/sara-python-template (which only ships files — GitHub template repos cannot copy repo settings).

Contents

The doc walks through 10 numbered sections, each with:

  • A description of the intended state.
  • A gh / gh api command to set it.
  • A gh / gh api command to verify it.
  • "Known drift" callouts flagging where existing repos deviate from the convention (based on a survey of the current sara-* repos).

Sections:

  1. Repository settings (merge methods, delete-branch-on-merge)
  2. Branch ruleset on main
  3. Required status checks
  4. GitHub Environments
  5. Actions secrets
  6. Actions variables
  7. Labels
  8. Dependabot
  9. CODEOWNERS
  10. Register in infrastructure

Plus a "Compliance check for existing repos" section at the end — one gh api snippet you can run against any repo to eyeball its current state.

Motivation

sara-python-template handles the file scaffolding for new services, but templates can't copy settings, environments, secrets, or rulesets. Today those are set per-repo, with drift:

  • Some sara repos have a branch ruleset called main, some default, two have none.
  • Required approving reviews vary (0 in sara-anonymizer, 1 in sara-rain-drop-detector).
  • Only sara-anonymizer has any GitHub Environments configured.
  • Several sara repos still hold obsolete ROBOTICS_AURORA* secrets from before the registry consolidation.

The doc gives contributors a single, reviewable source for "what does a properly-configured sara service repo look like" — without requiring org-admin access to set up rulesets at the org level.

Follow-ups (out of scope)

  • Promoting the ruleset from a per-repo pattern to an org-level ruleset targeting sara-* / isar-* / flotilla would remove the drift problem entirely. Requires org-admin access.
  • Retroactively applying the checklist to bring existing repos into compliance.

@Christdej
Christdej merged commit 490d429 into equinor:main Aug 18, 2026
2 checks passed
@Christdej
Christdej deleted the docs/new-repo-checklist branch August 18, 2026 05:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant