Skip to content

Modernize openvox-server landing page and nav#152

Merged
tuxmea merged 4 commits intoOpenVoxProject:masterfrom
miharp:feat/modernize-openvox-server-index
May 6, 2026
Merged

Modernize openvox-server landing page and nav#152
tuxmea merged 4 commits intoOpenVoxProject:masterfrom
miharp:feat/modernize-openvox-server-index

Conversation

@miharp
Copy link
Copy Markdown
Contributor

@miharp miharp commented May 5, 2026

Closes #150

Summary

  • Replaces the legacy index.markdown ToC (titled "Puppet Server: Index", with a Puppet Enterprise note and a canonical pointing at puppetserver/latest/) with a concise landing page modeled on the openvox agent index
  • New page describes what OpenVox Server is, explains the agent/server architecture, provides a 3-step getting-started path (pre-install → install → configure), and links to the Vox Pupuli support page
  • Adds a Core packages table noting the Java 17/21 requirement and that a JDK is not bundled
  • Removes the redundant "Index" top-level nav entry
  • Renames all remaining "Puppet Server" nav labels to "OpenVox Server"
  • Removes the dead external_ca_configuration.html nav link
  • Fixes a typo in the nav: "SSL germination" → "SSL termination"

Test plan

  • bundle exec jekyll serve — verify /openvox-server/latest/ renders the new landing page
  • Confirm the three getting-started links (pre-install, install, configure) resolve correctly
  • Confirm services_puppetserver.html resolves
  • Confirm the sidebar no longer shows an "Index" entry and all renamed labels appear correctly
  • Verify the removed external_ca_configuration.html nav entry no longer appears

@miharp miharp marked this pull request as ready for review May 5, 2026 13:07
@miharp miharp requested a review from a team as a code owner May 5, 2026 13:07
@tuxmea
Copy link
Copy Markdown
Contributor

tuxmea commented May 5, 2026

Older PR's have been merged. merge conflict needs to be solved

miharp and others added 2 commits May 6, 2026 06:10
Removes the legacy Puppet Server table-of-contents page and replaces it
with a concise landing page matching the style of the openvox agent index:
short description, how it works, getting started path, and community link.

Fixes broken links (puppetserver_vs_passenger.html missing,
external_ca_configuration.html missing), removes Puppet Enterprise note,
removes stale canonical pointing to /puppetserver/latest/, and removes
all "Puppet Server" branding.

Closes OpenVoxProject#150

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
- Remove explicit "Index" nav entry (landing page accessed via top nav)
- Rename "About Puppet Server" → "About OpenVox Server", pointing to
  services_puppetserver.html (created in PR OpenVoxProject#151)
- Rebrand "Configuring/Using and extending Puppet Server" section headings
- Fix broken external_ca_configuration.html link (file does not exist);
  remove the duplicate nav entry since "Intermediate CA" already covers it
- Fix "External SSL germination" typo → "External SSL termination"
- Update remaining "Puppet Server" labels to "OpenVox Server"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
@miharp miharp force-pushed the feat/modernize-openvox-server-index branch from 7127d92 to caa0986 Compare May 6, 2026 10:10
Modeled on the openvox agent index, noting the Java 17/21 requirement
and that a JDK is not bundled.

Signed-off-by: Michael Harp <mike@mikeharp.com>
Comment thread docs/_openvox-server_8x/index.markdown Outdated
For a full description of the service and its internal components, see
[About OpenVox Server](./services_puppetserver.html).

## Core packages
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.

Was a bit confused by "core packages". Thought about Puppet Core in first place. Not sure how confusing/critical it is for others.

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.

Hum, fair point, "Server packages" better?

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.

or "OpenVox Server packages"

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.

I prefer "OpenVox Server packages"

Avoids ambiguity with 'Puppet Core'.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
@tuxmea tuxmea merged commit cde1b87 into OpenVoxProject:master May 6, 2026
4 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.

Modernize openvox-server index page

3 participants