Skip to content

openvoxdb_8x: structural fixes and nav audit#234

Open
miharp wants to merge 2 commits into
OpenVoxProject:masterfrom
miharp:fix/openvoxdb-structural-fixes
Open

openvoxdb_8x: structural fixes and nav audit#234
miharp wants to merge 2 commits into
OpenVoxProject:masterfrom
miharp:fix/openvoxdb-structural-fixes

Conversation

@miharp
Copy link
Copy Markdown
Contributor

@miharp miharp commented May 21, 2026

Part of #206 — section 2: structural fixes and nav audit.

Summary

  • index.md: replaced broken symlink (which had become a stale duplicate of overview.markdown with a "SuSE" typo) with real landing page content; deleted overview.markdown and updated the 3 inbound links
  • configure_postgres.markdown: added missing YAML frontmatter; fixed 3 broken fragment links pointing to anchors in configure.html (section was moved to configure_postgres.html); converted indented code blocks to fenced with language specifiers; removed unused [config] reference definition
  • migration_coordination.markdown: fixed 7 broken [config#...] reference links (invalid Markdown syntax — converted to inline links with correct anchors in configure.html); converted setext headings to ATX; updated PostgreSQL 11 URL to /current/
  • puppetdb_connection.markdown: fixed broken #serverurltimeout anchor (correct anchor is #server_url_timeout)
  • install_from_packages.markdown: fixed configure_postgres link pointing to a section that moved from configure.html to configure_postgres.html
  • Nav additions: migration_coordination.html (Configuration), logging.html (Usage/admin), catalog_inputs.html + catalog_input_contents.html (Query API v4), catalog_inputs_format_v1.html + configure_expiration_format_v1.html (Wire formats)
  • Deleted: acceptance_tests.markdown (referenced Puppet's internal AWS infrastructure) and testing_storage_changes.markdown (referenced internal Leiningen/Clojure build tooling) — content not applicable outside Puppet's own development environment

Test plan

  • Jekyll builds cleanly with no errors
  • http://localhost:4000/openvoxdb/latest/ renders overview content (not a directory listing)
  • All newly nav-linked pages load and display correctly in the sidebar
  • Links within migration_coordination.html resolve to correct anchors in configure.html
  • Links within configure_postgres.html resolve to correct anchors in configure.html
  • acceptance_tests.html and testing_storage_changes.html return 404

- Replace duplicate index.md (was a broken symlink to overview.markdown)
  with real landing page content; remove overview.markdown
- Add missing YAML frontmatter to configure_postgres.markdown; fix broken
  fragment links pointing to configure.markdown anchors; convert indented
  code blocks to fenced with language specifiers
- Fix broken [config#...] reference links in migration_coordination.markdown;
  convert setext headings to ATX; update PostgreSQL 11 URL to /current/
- Fix broken #serverurltimeout anchor in puppetdb_connection.markdown
- Fix configure_postgres link in install_from_packages.markdown (section
  moved from configure.html to configure_postgres.html)
- Add previously unlisted pages to nav: migration_coordination.html,
  logging.html, catalog_inputs.html, catalog_input_contents.html,
  catalog_inputs_format_v1.html, configure_expiration_format_v1.html
- Remove acceptance_tests.markdown and testing_storage_changes.markdown
  (reference dead Puppet AWS infrastructure and internal Clojure tooling)

Signed-off-by: Michael Harp <[email protected]>
Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
@miharp miharp marked this pull request as ready for review May 21, 2026 10:59
@miharp miharp requested a review from a team as a code owner May 21, 2026 10:59
….markdown

Wrap four long prose paragraphs to stay within the 210-character limit.

Signed-off-by: Michael Harp <[email protected]>
Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
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.

1 participant