Skip to content

Replace 'master' terminology with 'server'#348

Open
silug wants to merge 1 commit into
OpenVoxProject:mainfrom
silug:issue_347
Open

Replace 'master' terminology with 'server'#348
silug wants to merge 1 commit into
OpenVoxProject:mainfrom
silug:issue_347

Conversation

@silug

@silug silug commented Feb 25, 2026

Copy link
Copy Markdown
Contributor

Puppet deprecated the 'puppet master' command in favor of 'puppet server' (Puppet Server) several versions ago, but significant documentation, help text, API docs, and code comments throughout the codebase still reference the outdated 'puppet master' terminology.

This commit updates user-facing strings, documentation, help text, man pages, API docs, code comments, and localization templates to use 'Puppet server' or 'Puppet Server' as appropriate.

Changes span:

  • CLI help text in application classes (agent, apply, device)
  • Face descriptions and summaries (catalog, facts, node, plugin, report)
  • Indirector terminus descriptions
  • Reference documentation (configuration, function, indirection, report, type)
  • API endpoint documentation (certificate, report, environments)
  • Internal documentation (indirector.md, profiling.md)
  • Man pages (generated troff files)
  • Localization template (puppet.pot)

Note: Acceptance tests and spec files that use 'master' as a Beaker test framework role identifier are intentionally not changed, as 'master' in that context refers to the Beaker DSL, not Puppet terminology. Internal Ruby code that maintains backwards compatibility with the 'master' run mode (e.g., run_mode.rb, settings handling) is also preserved.

Closes #347

@silug

silug commented Feb 25, 2026

Copy link
Copy Markdown
Contributor Author

Cherry-picked from puppetlabs/puppet#9572.

@silug silug marked this pull request as draft February 25, 2026 17:05
@silug silug force-pushed the issue_347 branch 3 times, most recently from 59aca4c to f17b0c3 Compare April 6, 2026 20:46
@silug silug marked this pull request as ready for review April 24, 2026 21:03
Puppet deprecated the 'puppet master' command in favor of 'puppet server'
(Puppet Server) several versions ago, but significant documentation, help
text, API docs, and code comments throughout the codebase still reference
the outdated 'puppet master' terminology.

This commit updates user-facing strings, documentation, help text, man pages,
API docs, code comments, and localization templates to use 'Puppet server'
or 'Puppet Server' as appropriate.

Changes span:
- CLI help text in application classes (agent, apply, device)
- Face descriptions and summaries (catalog, facts, node, plugin, report)
- Indirector terminus descriptions
- Reference documentation (configuration, function, indirection, report, type)
- API endpoint documentation (certificate, report, environments)
- Internal documentation (indirector.md, profiling.md)
- Man pages (generated troff files)
- Localization template (puppet.pot)

Note: Acceptance tests and spec files that use 'master' as a Beaker test
framework role identifier are intentionally not changed, as 'master' in
that context refers to the Beaker DSL, not Puppet terminology. Internal
Ruby code that maintains backwards compatibility with the 'master' run
mode (e.g., run_mode.rb, settings handling) is also preserved.

Closes OpenVoxProject#347

Co-authored-by: stuckvgn <stuckvgn@users.noreply.github.com>
Co-authored-by: Steven Pritchard <steven.pritchard@gmail.com>
Signed-off-by: Steven Pritchard <steven.pritchard@gmail.com>
@silug silug enabled auto-merge July 7, 2026 18:24
@silug silug disabled auto-merge July 7, 2026 18:30
Comment thread docs/indirector.md

`rest` terminus
Get a node via REST. Puppet agent uses this to allow the puppet master to override its environment.
Get a node via REST. Puppet agent uses this to allow the Puppet server to override its environment.

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.

should we stick with Puppet server for now, or update it to Openvox Server?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Good catch. I tried to fix those. I'll push another commit.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

On second thought, that level of rebranding is going to significantly increase the size of this PR. @bastelfreak is that OK?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@bastelfreak unless you have strong feelings about that, I'm going to work on the rebranding pass in #530.

@silug silug enabled auto-merge July 7, 2026 21:47
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.

[Deprecation] Replace puppet master Terminology in User-Facing Docs/Help

2 participants