Skip to content

Restore lang_tags, lang_collectors, lang_run_stages from Puppet 5.4 archive#86

Merged
tuxmea merged 1 commit intoOpenVoxProject:masterfrom
miharp:fix/lang-stubs-remaining
Apr 23, 2026
Merged

Restore lang_tags, lang_collectors, lang_run_stages from Puppet 5.4 archive#86
tuxmea merged 1 commit intoOpenVoxProject:masterfrom
miharp:fix/lang-stubs-remaining

Conversation

@miharp
Copy link
Copy Markdown
Contributor

@miharp miharp commented Apr 23, 2026

Scope

Restores the final three stub pages in docs/_openvox_8x/ from the
puppetlabs/docs-archive (puppet/5.4).

Changes

lang_tags.markdown — full content restored covering:

  • Automatic tagging (resource type, class name, namespace segments)
  • Containment propagation
  • tag metaparameter and tag function
  • Using tags: collecting resources, restricting catalog runs, reading tags in report handlers

lang_collectors.markdown — full content restored covering:

  • Syntax and search expressions (==, !=, and, or)
  • Location/usage rules (valid and invalid contexts)
  • Behavior (virtual resource realization, chaining, attribute overrides)
  • Exported resource collectors (<<| |>> syntax and behavior)

lang_run_stages.markdown — full content restored covering:

  • Default main stage
  • Declaring custom stages with ordering relationships
  • Assigning classes to stages via the stage metaparameter
  • Limitations (resource-like declaration required, no cross-stage notifications, containment caveats)

Adaptations from archive source:

  • Prose Puppet → OpenVox where describing runtime behavior
  • Removed Kramdown class tags ({:.concept}, {:.task}, {:.section})
  • Removed PE-specific PuppetDB install/connect links
  • Removed unused link definitions (MD053)
  • Renamed duplicate sub-headings to avoid MD024
  • Lines wrapped to 210 chars (MD013)

Test plan

  • bundle exec jekyll build succeeds with no errors
  • markdownlint-cli2 reports 0 errors against the project's planned 210-char config
    (see #30)

🤖 Generated with Claude Code

…rchive

Replace three stubs with full content:

lang_tags: automatic tagging, containment, tag metaparameter and
function, using tags for collection, catalog run restriction, and
custom report handlers.

lang_collectors: spaceship operator syntax, search expressions
(==, !=, and, or), location/usage rules, behavior (virtual resource
realization), and exported resource collectors.

lang_run_stages: default main stage, custom stages, assigning classes
to stages, and limitations (resource-like declaration required, no
cross-stage notifications, containment caveats).

Removes Kramdown class tags, updates prose Puppet -> OpenVox,
removes PE/PuppetDB install links, removes unused link definitions,
fixes duplicate headings (MD024), wraps lines to 210 chars (MD013).

Signed-off-by: Michael Harp <mike@mikeharp.com>
@miharp miharp requested a review from a team as a code owner April 23, 2026 16:14
@tuxmea tuxmea merged commit 25402ae into OpenVoxProject:master Apr 23, 2026
2 checks passed
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