Skip to content

docs: cleanup and consistency improvements across README, CONTRIBUTING, and component docs#67

Draft
NikolayS wants to merge 1 commit into
mainfrom
claude/cleanup-docs
Draft

docs: cleanup and consistency improvements across README, CONTRIBUTING, and component docs#67
NikolayS wants to merge 1 commit into
mainfrom
claude/cleanup-docs

Conversation

@NikolayS
Copy link
Copy Markdown
Contributor

Summary

  • Removed the orphaned scratch design doc TMP_MON_PREVIEWS.md (1518 lines, prefixed TMP_, contained duplicate changelog entries, not referenced anywhere; the same content lives in preview-infra/RUNBOOK.md and related code).
  • Fixed broken markdown structure in README.md: a stray inner <div align="center"> was center-aligning all bottom-half sections (Upgrading, K8s, Checkup reports, etc.), and a duplicated "Use cases" block repeated the top of the document. Reflowed the file, consolidated Links/Support into a single table at the end, dropped decorative emoji from H2 headers to match the cleaner top half, fixed an unterminated backtick.
  • Fixed stale/incorrect references: postgres_ai/-/issues -> postgresai/-/issues in cli/README.md; invalid check IDs U001/D004 -> real IDs H002/F004 in quality/QUALITY_ENGINEERING_GUIDE.md; postgresai monitoring -> postgresai mon in the same file; stray SQL outside a heredoc and a schedule mismatch ("every 20 minutes" vs daily cron) in workload_examples/single_index_analysis.md.
  • Normalized curly quotes to ASCII and tightened wording in CONTRIBUTING.md, components/index_pilot/README.md, components/index_pilot/CONTRIBUTING.md; minor heading/grammar fixes in SECURITY.md; trimmed trailing blank lines in pgai/README.md and postgres_ai_helm/README.md.

No code, config, or behavior changes — .md files only.

Test plan

  • Review rendered markdown on GitHub for README.md (verify center-align is gone from body sections, Links table renders, footer renders centered)
  • Verify no dead links remain (cli/README.md issues URL now points to postgresai/-/issues)
  • Verify CLI command examples in README and QUALITY_ENGINEERING_GUIDE match real commands (postgresai mon, check IDs H002/H004/F004/K003)
  • Confirm TMP_MON_PREVIEWS.md deletion is intended (content is preserved by preview-infra/RUNBOOK.md and the existing implementation under preview-infra/)

https://claude.ai/code/session_01U4F5KjW5neeCYxkKUZawfS


Generated by Claude Code

…G, and component docs

- Remove orphaned scratch design doc TMP_MON_PREVIEWS.md (1518 lines,
  duplicate changelog entries, not referenced; replaced by
  preview-infra/RUNBOOK.md).
- Fix broken markdown in README.md: remove broken centered-div wrap
  that left code blocks center-aligned, drop duplicated "Use cases"
  section, fix unterminated backtick, consolidate Links/Support, and
  drop decorative emoji from H2 headers for consistency with the top
  half of the document.
- Fix stale repo URL in cli/README.md (postgres_ai -> postgresai).
- Fix invalid check ID in QUALITY_ENGINEERING_GUIDE example summary
  (U001 -> H002, D004 -> F004) and correct CLI command reference
  (postgresai monitoring -> postgresai mon).
- Fix stray "SQL" delimiter outside heredoc and reschedule mismatch
  ("every 20 minutes" did not match the daily cron) in
  workload_examples/single_index_analysis.md.
- Normalize curly quotes to ASCII in CONTRIBUTING.md and
  components/index_pilot docs, tighten Recommendations wording.
- Minor SECURITY.md heading casing and grammar fixes.
- Trim trailing blank lines in pgai/README.md, postgres_ai_helm/README.md,
  components/index_pilot/CONTRIBUTING.md.

https://claude.ai/code/session_01U4F5KjW5neeCYxkKUZawfS
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants