Skip to content

Fix broken doc links and repo housekeeping - #17

Merged
EvgeniyPatlan merged 1 commit into
Percona-Lab:mainfrom
ImTheKai:fix/links-and-housekeeping
Nov 11, 2026
Merged

EvgeniyPatlan merged 1 commit into
Percona-Lab:mainfrom
ImTheKai:fix/links-and-housekeeping

Conversation

@ImTheKai

Copy link
Copy Markdown
Collaborator

Housekeeping pass ahead of a content refresh. No skill guidance changes; only links, frontmatter length, and repo docs.

Changes

  • 13 broken docs.percona.com links fixed (all returned 404; replacements verified 200):
    • PSMDB 8.0 pages: trailing / now redirect-loops, use .html
    • pg_tde index + limitations, PXB 8.4 privileges + xbcloud, PMM "add MySQL", PXC operator CR options, MongoDB operator scaling
    • PS 8.4 feature-highlights.html (gone) → feature-comparison.html
  • Jira links → perconadev.atlassian.net (jira.percona.com now redirects there).
  • Descriptions over the 1024-char Agent Skills limit: pxc-galera-operations (1062 → 976), percona-toolkit-recipes (1030 → 907). Dropped sentences are still covered in the bodies.
  • README install: the curl-only path silently dropped references/ for xtrabackup, toolkit, pxc and operators. Now documents copying the whole folder.
  • TESTING.md: prompts for the 8 merged MySQL skills that had none, a routing/negative-check section, glob-based symlink loop, removed stale "flip the repo public" and Valkey items.
  • Feedback issue template: no longer lists only 4 skills.

Follow-ups

Per-skill correctness PRs (facts that changed since May/June 2026: 9.7 LTS, PMM 3.9/3.10, PSMDB 8.3, PG 18, operator releases, percona-dk tool signature) and a CI static-check workflow are coming as separate PRs so each owner can review their area.

🤖 Generated with Claude Code

- Replace 13 docs.percona.com links that now 404 (PSMDB 8.0 pages need
  .html, pg_tde, PXB 8.4 privileges/xbcloud, PMM add-MySQL, operator
  pages, PS feature-highlights -> feature-comparison).
- Point Jira links at perconadev.atlassian.net (jira.percona.com redirects).
- Trim pxc-galera-operations and percona-toolkit-recipes descriptions under
  the 1024-char Agent Skills limit.
- README: the curl-only install dropped references/ for four skills; document
  copying the whole folder.
- TESTING.md: add prompts for the 8 merged MySQL skills, a routing/negative
  section, glob-based symlink loop; drop stale "flip public" and Valkey items.
- Feedback issue template: stop listing only 4 skills.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@EvgeniyPatlan EvgeniyPatlan left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM. Checked all the new URLs, they resolve, and both long descriptions are now under 1024 (pxc 977, toolkit 908).

Small follow-up for later: if #23 (pcsm-recipes) lands, the README list of skills that ship references/ should include it too.

Also note #19, #21, #27 and #28 conflict with this one, so they'll need a rebase after it's merged.

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