Archived public repos carry a type; snapshots declare their backing content - #15
Open
Ethan-Arrowood wants to merge 4 commits into
Open
Archived public repos carry a type; snapshots declare their backing content#15Ethan-Arrowood wants to merge 4 commits into
Ethan-Arrowood wants to merge 4 commits into
Conversation
There was a problem hiding this comment.
Code Review
This pull request updates the repository policy and taxonomy documentation to transition from using GitHub topics to the repo-type organization custom property for classifying public repositories. It also refines the guidelines for archiving repositories, including when to keep them public versus moving them internal, and introduces metadata requirements for snapshot repositories. The review feedback focuses on improving the clarity and professionalism of the documentation, suggesting more precise phrasing regarding the property settings for private repositories, the decision-making process for archiving, and the classification of archived repos.
…ontent Doc changes backing the public-archive cleanup (HarperFast/ospo#115). - Type is recorded as the `repo-type` org custom property, not a GitHub topic. The topic projection never really ran; the property has been live on every public active repo since HarperFast/ospo#113. The doc had not caught up. - Scope widens from "active, public" to "public": an archived repo keeps its taxonomy type and its archive note, and is exempt from the rest. An archived repo's type is what tells a reader what they are looking at. - Keep-public vs internal is now a judgment with a stated reason on both sides rather than a default-to-public. Replaces the aside about the old Custom Functions repos, whose disposition is now decided. - The archive note uses the `harper.fast` docs and Discord links, and the "adapt the wording" guidance covers superseded repos, package sources, repos where no pinned version applies, and non-Markdown READMEs. - New requirement: a `snapshot` sets its `homepage` to the content it backs and links that content in the note. Tooling reads `homepage`, so the link does not depend on README prose. No backing artifact means it is not a snapshot. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Ethan-Arrowood
force-pushed
the
archive-taxonomy-scope
branch
from
July 30, 2026 17:18
3cb198a to
4c9db2d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Doc side of the public-archive cleanup — HarperFast/ospo#115, part of #66. The dispositions for all 57 public archived repos are proposed here; this PR makes the policy and taxonomy say what we're now doing.
What changes
Type lives in the
repo-typecustom property, not a GitHub topic. The doc still described the topic projection, which effectively never ran — only two public repos ever carried a type topic. The property has been live on every public active repo since ospo#113. GitHub enforces the value list, only org admins can write it, and it reads org-wide in one call.Scope widens from "active, public" to "public". An archived repo keeps its taxonomy type and its archive note, and is exempt from the rest of the requirements — it's read-only by definition. An archived repo's type is precisely what tells a reader what they're looking at, so dropping it on archival threw away the useful part.
Keep-public vs. move-internal becomes a judgment with a stated reason. The old text defaulted to public because "the cost is low." That's the part worth revisiting: a stale public repo is training surface, and old practices keep teaching humans and agents the wrong thing long after the code stops mattering. The new text asks for the reference value to be weighed against that per repo, with the evidence recorded. This also replaces the standing aside about the old Custom Functions repos, whose disposition is now decided.
Snapshots declare their backing content in the repo
homepagefield and link it in the archive note. Tooling readshomepage, so the link doesn't depend on README prose surviving. It also gives us a test for the type itself: no dated artifact, not a snapshot. None of the 10 public snapshot repos hashomepageset today; that's being backfilled in the same pass.Archive note links use the
harper.fastforms (docs.harper.fast,harper.fast/discord) rather than thedocs.harperdb.io/discord.com/invite/...URLs they resolve to. The notes added so far are split between the two.The "adapt the wording" guidance is spelled out — superseded repos, repos that produced a published package, repos where no pinned version applies, and non-Markdown READMEs (
sdk-javais AsciiDoc, where a Markdown alert renders as literal text).Notes for review
docs.harperdb.ioelsewhere in the taxonomy doc are left alone — the decision was scoped to the archive note.docs.harper.fastpreserves paths, so normalizing the rest is a clean follow-up if wanted.repo-typeset".