Skip to content

Add agent install overview, component versions table, and clean up stale content#71

Open
miharp wants to merge 2 commits intoOpenVoxProject:masterfrom
miharp:docs/agent-install-what-and-where
Open

Add agent install overview, component versions table, and clean up stale content#71
miharp wants to merge 2 commits intoOpenVoxProject:masterfrom
miharp:docs/agent-install-what-and-where

Conversation

@miharp
Copy link
Copy Markdown
Contributor

@miharp miharp commented Apr 20, 2026

Summary

  • New page: install_what_and_where.markdown — documents where the openvox-agent package installs binaries, config, code, cache, logs, and the system service/user on *nix and Windows, linked from the "Installing and upgrading" nav section
  • Component versions table: added to about_agent.md seeded from 8.25.0 onward (OpenFact, Ruby, OpenSSL per release); also fixed broken {{facter}}, {{hiera}}, {{puppetserver}} links (all resolved to /), renamed Facter→OpenFact, and updated puppet applyopenvox apply
  • Removed release_notes_agent.md: contained stale Puppet 5.x content; all references redirected to release_notes.html

Signed-off-by: Michael Harp mike@mikeharp.com

…ale content

- Add install_what_and_where.markdown: new page documenting where the
  openvox-agent package installs binaries, config, code, cache, logs,
  and the system service/user on *nix and Windows
- Add component versions table to about_agent.md seeded from 8.25.0
  onward (OpenFact, Ruby, OpenSSL per release), fix broken links
  ({{facter}}, {{hiera}}, {{puppetserver}} all resolved to /), rename
  Facter→OpenFact, and update puppet apply→openvox apply
- Remove release_notes_agent.md (stale Puppet 5.x content) and redirect
  all references to release_notes.html
- Add new page to nav under "Installing and upgrading"

Signed-off-by: Michael Harp <mike@mikeharp.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@miharp miharp requested a review from a team as a code owner April 20, 2026 14:10
Comment thread _data/nav/openvox_8x.yml
link: "about_agent.html"
- text: OpenVox agent release notes
link: "release_notes_agent.html"
- text: Quick start guides
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.

Why did you remove the release notes?

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.

release_notes_agent.md: contained stale Puppet 5.x content; all references redirected to release_notes.html

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.

This stuff,

Image

* [Puppet known issues]({{puppet}}/known_issues.html)
* [System requirements]({{puppet}}/system_requirements.html)
* [Component versions in `puppet-agent`]({{puppet}}/about_agent.html)
* [Puppet agent release notes]({{puppet}}/release_notes_agent.html)
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.

This file is unused and a remaining artifact from the old puppet docs.
Please check _data/nav/openvox_8x.yml to add the new document to the navigation menu.

File is an unused artifact from the original Puppet docs import;
removing it from the PR diff per reviewer feedback.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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