Skip to content

Use version tag, not SHA, in OpenBolt generated note#342

Merged
corporate-gadfly merged 1 commit into
OpenVoxProject:masterfrom
miharp:fix/openbolt-version-note-336
Jun 18, 2026
Merged

Use version tag, not SHA, in OpenBolt generated note#342
corporate-gadfly merged 1 commit into
OpenVoxProject:masterfrom
miharp:fix/openbolt-version-note-336

Conversation

@miharp

@miharp miharp commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Problem

The "generated from" note on the OpenBolt generated reference pages showed the
upstream commit SHA instead of the clean version tag, unlike OpenVox and
OpenFact which show the tag:

OpenBolt:  generated from the OpenBolt source code based on version 41282c5265c0e4763d7c5f962636edefd675e6e8 on ...
OpenFact:  generated from the OpenFact source code based on version 5.6.1 on ...

Fix

lib/puppet_references/openbolt/docs.rb passed @commit (the resolved SHA from
Repo#checkout) into the note. OpenVox/OpenFact instead use the pinned version
tag held in PuppetReferences.version_commit. This change makes OpenBolt match
them.

PuppetReferences.version_commit is set in build_openbolt_references before
Docs.new runs, so it holds the pinned tag.

Verification

Built the references locally with the pinned version:

bundle exec rake references:openbolt INSTALLPATH=docs

The generated note now reads the version tag instead of the SHA:

> **NOTE:** This page was generated from the OpenBolt source code based on version 5.6.0 on 2026-06-18 11:19:08 -0400. Do not edit it here; fix it upstream.

ruby -c and rubocop both pass on the changed file.

Closes #336

OpenBolt's 'generated from' note showed the resolved commit SHA while
OpenVox and OpenFact show the clean version tag. Pass
PuppetReferences.version_commit (the pinned tag) to generated_note
instead of @commit (the SHA from Repo#checkout), matching the other
collections.

Closes OpenVoxProject#336

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
@miharp miharp requested a review from a team as a code owner June 18, 2026 15:22

@corporate-gadfly corporate-gadfly left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

+1

@corporate-gadfly corporate-gadfly merged commit 1f52f7b into OpenVoxProject:master Jun 18, 2026
5 checks passed
@miharp miharp deleted the fix/openbolt-version-note-336 branch June 18, 2026 21:07
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.

OpenBolt generated pages show commit SHA instead of version tag in the 'generated from' note

2 participants