Skip to content

Drop the remaining branding reference from the website docs - #14

Merged
bingran-you merged 1 commit into
mainfrom
bry/remove-skillsbench-refs
Jul 28, 2026
Merged

Drop the remaining branding reference from the website docs#14
bingran-you merged 1 commit into
mainfrom
bry/remove-skillsbench-refs

Conversation

@bingran-you

Copy link
Copy Markdown
Collaborator

Removes the last prose reference to the other BenchFlow benchmark, and makes the existing rule cover the place it survived.

The reference

website/README.md opened by crediting that project for the site's design. Now it describes the site on its own terms — same information about what the site is, none of the borrowed identity.

Why it survived

lint_frontierphysics_docs.py already forbids this branding, but documentation_files() only collected the root docs, docs/**/*.md and .agents/**/*.md. website/ was never scanned, so the reference sat there passing CI.

Now the website's markdown is scanned too — 36 documentation files instead of 35. Verified both directions: re-introducing the phrase fails the check with ERROR: website/README.md contains stale branding: 'SkillsBench', and it passes once clean.

Two mentions left on purpose

Location Why
lint_frontierphysics_docs.py:20 The forbidden-pattern regex. It has to name the branding to detect it — deleting it would disable the rule.
NOTICE:6 Apache-2.0 attribution, not branding. See below.

NOTICE needs your call

NOTICE records that the repository's task-package conventions, authoring guidance, validation scripts and review tooling are adapted from an Apache-2.0-licensed project. Apache-2.0 §4(d) requires derivative works to carry forward the attribution notices from the original's NOTICE file, so if that adaptation is real, this text is a licence obligation and removing it would put the repo out of compliance.

I have not touched it. If the adaptation claim is no longer accurate — the tooling has been rewritten since — then it can be removed as simply stale, but that is a factual call about provenance rather than a branding one, and it is yours to make.

Verification

  • No mention remains in any tracked file except the two above (package-lock.json excluded — dependency metadata).
  • No mention in the rendered site output.
  • Clean website lint and build; ruff clean on the changed script.
  • All five repo validators pass.

The website README credited another BenchFlow site for the design. Remove it
and describe the site on its own terms.

The documentation linter already forbids that branding, but only scanned the
root docs, docs/ and .agents/ — website/ sat outside the check, which is how
the reference survived. Scan the website's markdown too, so this cannot creep
back in.

Left in place deliberately: the pattern inside the linter itself, which has to
name the branding in order to detect it, and the NOTICE attribution, which is
an Apache-2.0 obligation rather than branding.
@vercel

vercel Bot commented Jul 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
frontierphysics-site Ready Ready Preview, Comment Jul 28, 2026 3:36am

Request Review

@bingran-you
bingran-you merged commit e4b2c29 into main Jul 28, 2026
5 checks passed
@bingran-you
bingran-you deleted the bry/remove-skillsbench-refs branch July 28, 2026 03:37

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8d8baf130d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

# The public website is documentation too. It sat outside this check long
# enough to accumulate stale branding the check exists to prevent.
files.extend(path for path in (ROOT / "website").glob("*.md"))
files.extend((ROOT / "website" / "src").rglob("*.md"))

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Scan the source files that render the public website

When stale branding is added to the actual public-site copy, such as website/src/app/page.tsx or website/src/app/contribute/page.tsx, this CI check still succeeds because the new traversal only includes *.md. The current website has no Markdown under src; its user-facing pages are TSX, so this addition protects the developer README but not the rendered website described by the comment. Include the relevant .tsx/.ts source files in the scan so branding cannot return on the public site unnoticed.

Useful? React with 👍 / 👎.

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