Skip to content

Remove template placeholders and align experiment titles - #26

Merged
daveh-beep merged 1 commit into
mainfrom
agent/repo-hygiene
Oct 16, 2026
Merged

daveh-beep merged 1 commit into
mainfrom
agent/repo-hygiene

Conversation

@daveh-beep

Copy link
Copy Markdown
Collaborator

What changed

  • .github/ISSUE_TEMPLATE/config.yml: the contact link was https://discord.gg/block-opensource (/add your discord channel if applicable), which is a broken placeholder URL. It now links to the Block open source Discord.
  • Issue template: bug-report.md asked for "Go to / Click / Scroll" steps, an OS, and assignees: add codeowner's @name here. It is replaced by protocol-problem.md, which asks for the document and section, the problem, the host and release where it was found, and the sovereignty impact.
  • CODEOWNERS: removed the unused template text. The owner is unchanged: @daveh-beep.
  • Experiments: 0009 and 0010 used Experiment 0009 — Title. The others use Experiment 0001: Title. Both now use the colon form. EXPERIMENTS.md now says that numbers are identifiers and gaps are expected, because 0004, 0005, 0007, and 0008 do not exist.

Not changed: 0009 and 0010 are still shorter than the template. Expanding them changes experiment design, so it belongs in its own PR.

Not needed: SECURITY.md and CONTRIBUTING.md. block/.github supplies both for every repo in the org.

Status of this change

  • Project maintenance

Reversibility and migration

Revert the PR.

Validation

scripts/check-docs.py from #23 passes on this branch.

The issue config linked to a placeholder Discord URL, the bug template
asked for an assignee placeholder and app click steps, and CODEOWNERS
carried unused template text. The issue template now asks for the
document, section, and release. Experiments 0009 and 0010 use the same
title form as the others, and EXPERIMENTS.md says number gaps are expected.
@delkc
delkc self-requested a review October 15, 2026 20:20
@delkc
delkc self-requested a review October 16, 2026 14:09
@daveh-beep
daveh-beep merged commit 32f51cc into main Oct 16, 2026
2 checks passed
@daveh-beep
daveh-beep deleted the agent/repo-hygiene branch October 16, 2026 14:24
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.

2 participants