docs: Standardize terminology and add code block language tags

[chadmf]

Description

Systematic documentation cleanup implementing Phase 2 & 3 of the comprehensive documentation improvement plan. This PR standardizes terminology across 16 documentation files and adds proper syntax highlighting to improve readability and professional presentation.

Changes Made

Phase 2 - Terminology Standardization:

• Replaced 100+ instances of "Postgres" with "PostgreSQL" for brand consistency
• Preserved "Trusted Postgres Architect" (official product name)
• Preserved lowercase "postgres" in technical contexts (users, namespaces, commands)
• Standardized "datacenter" (one word) throughout
• Ensured consistent DC1/DC2 capitalization
• Expanded first AAP mentions to "Ansible Automation Platform (AAP)"

Phase 3 - Code Block Language Tags:

• Added language tags to 40+ code blocks for proper syntax highlighting
• Tagged shell commands with ```bash
• Tagged output examples with ```text
• Tagged configuration files with ```ini, ```properties
• Tagged diagrams with ```text

Files Modified (16):

• User-facing: quick-start-guide.md, troubleshooting.md
• Operational: dr-testing-guide.md, scripts-guide.md, manual-scripts-doc.md
• Deployment: install-kubernetes-manual.md, install-tpa.md, install-rhel-manual.md
• Architecture: architecture.md, aap-openshift-dr-architecture.md
• Reference: aap-components-reference.md, aap-containerized-*.md
• Validation: dr-replication-validation-report.md, split-brain-prevention.md
• Testing: openshift-edb-operator-smoke-test.md, haproxy-pgbouncer-*.md

Quality Improvements:

• Removed emoji/checkmarks from tables for better accessibility
• Improved professional presentation
• Enhanced searchability with consistent terminology
• Better syntax highlighting for code examples

Statistics:

• 16 files modified
• 264 lines changed (132 insertions, 132 deletions)
• 100+ terminology standardizations
• 40+ code blocks enhanced

Testing

• Pre-commit hooks passed
• All changes reviewed for accuracy and consistency
• Documentation standards compliance verified (CONTRIBUTING.md)
• Cross-references and links validated
• Code block syntax verified for proper rendering
• Terminology consistency checked across all modified files
• Protected file excluded as requested (aap-containerized-enterprise-dr-architecture.md)
• Backup created: docs-backup-20260406-181510.tar.gz

Validation performed:

• Grep search confirmed 100+ "Postgres" → "PostgreSQL" replacements
• Verified proper preservation of technical contexts (lowercase "postgres")
• Confirmed code block language tags render correctly
• Checked all 16 files for consistency
• Verified no functional changes to technical content

Related Work

This PR is part of a comprehensive documentation cleanup initiative:

• Follows standards defined in CONTRIBUTING.md and CLAUDE.md
• Implements Phase 2 & 3 of documented cleanup plan
• Future phases will address cross-references, formatting, and TOC improvements

Impact

Positive:

• Improved professional presentation
• Better accessibility (removed decorative emojis)
• Enhanced syntax highlighting for code examples
• Consistent terminology for better searchability
• Aligned with industry standard branding (PostgreSQL)

No Breaking Changes:

• All changes are cosmetic/presentational
• No functional modifications to code, commands, or technical procedures
• All technical references preserved accurately

Checklist

• Documentation updated
• Tests pass (pre-commit, validation)
• No breaking changes
• Follows conventional commit format
• PR description complete
• Changes align with CONTRIBUTING.md standards

Generated with Claude Code