Skip to content

README: the GitLab component was never real, and we vendor 1.0.3 - #7

Closed
pavel-te wants to merge 1 commit into
mainfrom
ci18-7363-readme-truth
Closed

README: the GitLab component was never real, and we vendor 1.0.3#7
pavel-te wants to merge 1 commit into
mainfrom
ci18-7363-readme-truth

Conversation

@pavel-te

@pavel-te pavel-te commented Jul 30, 2026

Copy link
Copy Markdown
Collaborator

Three claims on the front page were false as of v1.1.1.

"Both pin ptc-cli v1.0.2" — we vendor 1.0.3 since #6. The number was never
going to stay right by hand; it now points at the tree the action actually
ships, and the self-test already asserts the vendored VERSION.

"GitLab: a CI/CD Catalog component" with an include: component: recipe. That
address can never resolve for anyone: GitLab resolves it against the reader's
own instance, so a component we publish on one server is unreachable from
gitlab.com and from every self-hosted install. ptc init moved to printing an
inline job for that reason — but the README kept advertising the component,
and templates/translate/template.yml kept sitting in a GitHub repo where no
GitLab could read it. Both are gone. The GitLab section now carries the same
job ptc init prints, including the PTC_GIT_PUSH_TOKEN fallback and the
[skip ci] guard, plus the sha256 for anyone who wants the integrity check
vendoring gives the GitHub side for free.

"[skip translations] marker ... as a second guard" — GitHub honours only
[skip ci], [ci skip], [no ci], [skip actions] and [actions skip]. The marker
is a label, not a guard; loop safety comes from the paths: trigger and the
fact that ptc/translations is not a trigger branch. Said so, rather than
letting a reader design around a token that does nothing.

Also drops config-file from the quick start: api-token is the only input you
must pass, and a root .ptc-config.yml is picked up on its own.

The self-test step that parsed templates/ now asserts the directory stays
gone, so a component cannot come back by accident.

…r 1.0.3

Three claims on the front page were false as of v1.1.1.

"Both pin ptc-cli v1.0.2" — we vendor 1.0.3 since #6. The number was never
going to stay right by hand; it now points at the tree the action actually
ships, and the self-test already asserts the vendored VERSION.

"GitLab: a CI/CD Catalog component" with an include: component: recipe. That
address can never resolve for anyone: GitLab resolves it against the reader's
own instance, so a component we publish on one server is unreachable from
gitlab.com and from every self-hosted install. ci18-7363 established this and
moved `ptc init` to printing an inline job — but the README kept advertising
the component, and templates/translate/template.yml kept sitting in a GitHub
repo where no GitLab could read it. Both are gone. The GitLab section now
carries the same job ptc init prints, including the PTC_GIT_PUSH_TOKEN
fallback and the [skip ci] guard, plus the sha256 for anyone who wants the
integrity check vendoring gives the GitHub side for free.

"[skip translations] marker ... as a second guard" — GitHub honours only
[skip ci], [ci skip], [no ci], [skip actions] and [actions skip]. The marker
is a label, not a guard; loop safety comes from the paths: trigger and the
fact that ptc/translations is not a trigger branch. Said so, rather than
letting a reader design around a token that does nothing.

Also drops config-file from the quick start: ci18-7277 made api-token the only
input you must pass, and a root .ptc-config.yml is picked up on its own.

The self-test step that parsed templates/ now asserts the directory stays
gone, so a component cannot come back by accident.
@pavel-te pavel-te closed this Jul 30, 2026
@pavel-te pavel-te reopened this Jul 30, 2026
@pavel-te pavel-te changed the title [ci18-7363] README: the GitLab component was never real, and we vendor 1.0.3 README: the GitLab component was never real, and we vendor 1.0.3 Jul 30, 2026
@pavel-te pavel-te closed this Jul 30, 2026
@pavel-te
pavel-te deleted the ci18-7363-readme-truth branch July 30, 2026 09:34
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