Skip to content

ci: pin docs-engine to v0.3.0 for the default Contributing page - #8

Merged
burinc merged 1 commit into
mainfrom
ci/bump-docs-engine-v0.3.0
Sep 7, 2026
Merged

ci: pin docs-engine to v0.3.0 for the default Contributing page#8
burinc merged 1 commit into
mainfrom
ci/bump-docs-engine-v0.3.0

Conversation

@burinc

@burinc burinc commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

docs-engine v0.3.0 (jlt-commons/docs-engine#2) adds a default guide/contributing.html to every project's site. The shared ci-builds/site.yml still defaults to v0.2.0, so this pins explicitly rather than waiting for that default to move.

Verified locally: built against the merged v0.3.0 checkout, docs/check-site.sh passes (4 guide pages now, up from 2).

jlt-commons/ci-builds' shared site.yml still defaults to v0.2.0. Pinning
here explicitly, rather than waiting for that default to move, is what
actually gets the new guide/contributing.html onto this project's
published site.

Verified locally against the merged v0.3.0 checkout before pinning:
raylib-android's own docs/check-site.sh passes against the build (4 guide
pages now, up from 2; 33 images unchanged).
@burinc
burinc merged commit 18bd3ea into main Sep 7, 2026
6 checks passed
@burinc
burinc deleted the ci/bump-docs-engine-v0.3.0 branch September 7, 2026 04:37
burinc added a commit to jlt-commons/glitter-uikit that referenced this pull request Sep 7, 2026
docs-engine v0.3.0 adds an automatic Contributing page to every
project's generated guide, with no config needed and no override in
place here. The shared site.yml workflow still defaults to v0.2.0, so
pinning this project's docs-engine-ref explicitly is what actually
gets the new page onto glitter-uikit's live site, and it also keeps
this build reproducible if that shared default moves again later.

Same change already landed in jlt-commons/raylib-android#8.
burinc added a commit to jlt-commons/glitter-gl that referenced this pull request Sep 7, 2026
docs-engine v0.3.0 adds an automatic Contributing page to every
generated site, purely additive and overridable by a project's own
docs/guide/contributing.md. The shared site.yml workflow still
defaults its docs-engine-ref input to v0.2.0, so this project needs
an explicit pin to actually pick up the new page on its published
site.

Pinning here rather than relying on the shared default also keeps
this project's build reproducible the next time that default moves.

Same pattern already landed in jlt-commons/raylib-android#8.
burinc added a commit to jlt-commons/glitter that referenced this pull request Sep 7, 2026
docs-engine v0.3.0 adds an automatic Contributing page to every
project's generated guide, purely additive and overridable by a
project's own docs/guide/contributing.md. The shared site.yml
reusable workflow still defaults docs-engine-ref to v0.2.0, so
pinning it here explicitly is what actually gets the new page onto
this project's live site.

Pinning also keeps the build reproducible: once the shared
default moves past v0.3.0, this project won't pick up a later
version until someone bumps the pin on purpose.

Same change as jlt-commons/raylib-android#8.
burinc added a commit to jlt-commons/awesome-jolt that referenced this pull request Sep 7, 2026
docs-engine v0.3.0 adds an automatic Contributing page to every
project's generated guide, purely additive and overridable by a
project's own docs/guide/contributing.md. The shared site.yml
workflow's docs-engine-ref input still defaults to v0.2.0, so this
project won't pick up the new page until it pins the newer version
itself.

Pinning explicitly, rather than tracking the shared workflow's
default, also keeps this project's build reproducible the next time
that default moves.

Same pattern already landed in jlt-commons/raylib-android#8.
burinc added a commit to jlt-commons/ebb that referenced this pull request Sep 7, 2026
docs-engine v0.3.0 adds an automatic Contributing page to every
generated site, purely additive and overridable by a project's own
docs/guide/contributing.md. The shared reusable workflow still
defaults docs-engine-ref to v0.2.0, so picking up the new page here
means naming v0.3.0 explicitly rather than waiting on the shared
default to move.

Pinning it also keeps this project's site build reproducible: a
future bump of the shared default won't silently change what this
repo publishes until the pin is bumped on purpose.

Mirrors jlt-commons/raylib-android#8.
burinc added a commit to jlt-commons/raygui-jlt that referenced this pull request Sep 7, 2026
docs-engine v0.3.0 adds an automatic Contributing page to every
project's generated guide, purely additive and overridable by a
project's own docs/guide/contributing.md. The shared site workflow
still defaults docs-engine-ref to v0.2.0, so picking up the new page
on this project's live site needs an explicit pin rather than waiting
on the shared default to move.

Pinning explicitly also means this project's site build stays
reproducible even after that default moves again later.

Same change already landed in jlt-commons/raylib-android#8.
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