Fix broken .md links in generated OpenBolt docs

[miharp]

Summary

• Adds a rewrite_md_links step to the OpenBolt doc copy pipeline that converts relative .md cross-reference links to .html so they resolve correctly once Jekyll has processed the collection
• Handles both markdown-style links [text](file.md) and raw HTML <a href="file.md"> attributes
• Absolute http/https URLs are left untouched
• Anchors (#section) are preserved

Why not jekyll-relative-links?

jekyll-relative-links was evaluated first. It only processes markdown-style links after Kramdown converts them — it does not touch raw HTML <a href="..."> attributes that appear verbatim in the source. The bolt docs use raw HTML for most of their cross-references (e.g. the "Helpful Bolt docs links" table on the index page), so the plugin left the majority of broken links unresolved. The in-pipeline rewrite covers both formats in one pass.

Implementation note

Capture groups are assigned to local variables before calling .sub() inside each gsub block. Calling .sub() resets Regexp.last_match, so reading group 2 (the anchor) after it would silently return nil and drop #section from rewritten links.

Test plan

• bundle exec rubocop lib/puppet_references/openbolt/docs.rb — no offenses
• bundle exec rake references:openbolt INSTALLPATH=docs && bundle exec jekyll build — clean build
• No href="*.md" links remain in _site/openbolt/latest/index.html
• Anchored links (e.g. file.md#section) rewrite to file.html#section
• Absolute URLs unchanged

[miharp]

Closing — parent PR #143 is being reverted. Will reopen once the missing generated reference pages are handled.