feat: migrate HTTP API docs from openvox_8x to openvox-server_8x (#250)

[miharp]

Summary

• Migrates 9 Puppet v3 API endpoint pages from docs/_openvox_8x/http_api/ into docs/_openvox-server_8x/, updating front matter, schema links, and heading style to match the collection conventions
• Removes 3 pages for endpoints deleted upstream (resource_type, environment, status) and deletes the now-empty docs/_openvox_8x/http_api/ directory
• Adds 3 new CA v1 endpoint pages written from scratch: certificate expirations, certificate renewal, and bulk certificate sign — verified against the OpenVox Server Clojure source and a live Vagrant environment
• Restructures the openvox-server_8x sidebar nav into a single "HTTP API" parent with Puppet v3, Puppet v4, and CA v1 sub-groups
• Replaces the openvox_8x HTTP API nav section with a single cross-link to the openvox-server collection
• Fixes _includes/nav-item.html to not prepend the collection base URL to nav links that are already absolute paths (starts with /) — this PR introduced the first cross-collection nav link, which exposed the bug

CA endpoint verification (live Vagrant)

All three new CA v1 pages were verified against a running OpenVox Server in Vagrant (puppet.example.com).

Certificate Expirations (GET /puppet-ca/v1/expirations):

HTTP/1.1 200 OK
Content-Type: application/json

{
  "ca-certs": {
    "Puppet CA: puppet.example.com": "2041-05-15T11:22:16UTC",
    "Puppet Root CA: c6cb234925032e": "2041-05-15T11:22:14UTC"
  },
  "crls": {
    "Puppet CA: puppet.example.com": "2031-05-25T14:36:06UTC",
    "Puppet Root CA: c6cb234925032e": "2041-05-15T11:22:14UTC"
  }
}

Two entries per key because the Vagrant environment uses an intermediate CA. CA cert expiry reflects the 15-year default from puppetserver ca setup; CRL next-update reflects the 5-year ca_ttl rotation cycle.

Certificate Renewal (POST /puppet-ca/v1/certificate_renewal):

With allow-auto-renewal: false (default):

HTTP/1.1 404 Not Found

Confirmed: endpoint returns 404 when auto-renewal is disabled, as documented.

Bulk Certificate Sign (POST /puppet-ca/v1/sign):

Schema violation (non-string certname value) returns:

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{"kind":"schema-violation","submitted":[42],"error":"[(not (instance? java.lang.String 42))]"}

Test plan

• npx markdownlint-cli2 passes with 0 errors on all 13 changed files
• CA v1 endpoint responses verified against live Vagrant environment
• CA v1 endpoint routes and response shapes verified against OpenVox Server source (certificate_authority_core.clj)
• Nav renders correctly in bundle exec jekyll serve — "HTTP API" parent expands with Puppet v3, Puppet v4, and CA v1 sub-groups, all links active
• All 27 relative links in http_api_index.markdown resolve to existing pages
• Cross-collection nav link (/openvox-server/latest/http_api_index.html) renders without double-slash and resolves correctly

Closes #250

[tuxmea]

old puppet docs url

[tuxmea]

old puppet docs url

[tuxmea]

old puppet docs url