Skip to content

comment-and-doc-style SKILL.md title-case PR-title example leaves "devcontainer" lowercase #1078

Description

@ptr727

Evidence

.github/skills/comment-and-doc-style/SKILL.md's "PR titles and commit messages" section states
the title-case rule (title case, with lowercase short bind words a, an, the, and, but, or, of, in, on, at, to, by, for, from as the sole exception), then gives five example titles right below
it, including:

Clarify devcontainer Setup Steps in README

devcontainer is not a short bind word and is not named as an exception anywhere in the rule, so
this example is internally inconsistent with the rule it's meant to illustrate.

Confirmed by Copilot review on ptr727/PhotoCleaner#87 (this file is carried verbatim via
scripts/carry.py, fully hub-owned, so a downstream repo can't fix its own copy without
diverging from the carry digest on the next check).

Expected

Clarify Devcontainer Setup Steps in README (or drop the example / pick a different one if
devcontainer is meant to be treated as a proper-noun-like technical term that keeps its own
casing — if so, that exception should be stated in the rule itself, since nothing today says so).

Repo, ref

ptr727/ProjectTemplate at main@b823bc4 (as of this filing), .github/skills/comment-and-doc-style/SKILL.md.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions