Skip to content

docs(postgresql): improve overview extensions section and expand FAQs#245

Merged
weicao merged 1 commit intomainfrom
docs/postgresql-overview-faqs
Apr 9, 2026
Merged

docs(postgresql): improve overview extensions section and expand FAQs#245
weicao merged 1 commit intomainfrom
docs/postgresql-overview-faqs

Conversation

@weicao
Copy link
Copy Markdown
Contributor

@weicao weicao commented Apr 9, 2026

Closes #244

Changes

Overview — Pre-installed Extensions

Replaced the misleading single-row "Supported Extensions" table with a full "Pre-installed Extensions" section:

  • Version matrix covering PG12.22.0 → PG18.1.0 (6 versions), all verified on live EKS clusters
  • 11 extensions documented with SQL names, per-version versions, and whether they are enabled by default
  • Categorized descriptions with minimal SQL examples: AI/Vector · Geospatial · Time-series · Analytics · Search · Observability · Security · Scheduling · Data Management · Replication
  • Availability notes: pg_duckdb absent on PG12; roaringbitmap PG18 only; pg_duckdb 0.3.0 on PG14–PG17 vs 1.1.0 on PG18

FAQs — 4 new entries

# Question
4 How to check replication lag on standby replicas
5 How to connect to a read replica directly
6 What triggers automatic failover, and does it require manual intervention?
7 How to adjust pgbouncer connection pool settings

Test plan

  • Overview page renders correctly, version matrix table displays properly
  • FAQ anchors work for all 7 entries
  • SQL code blocks are syntax-highlighted correctly

Overview:
- Replace misleading "Supported Extensions" table (pgvector only) with
  a comprehensive "Pre-installed Extensions" section covering 11 extensions
  across PG12–PG18, verified by live cluster tests
- Add per-version extension version matrix (PG12.22.0 through PG18.1.0)
  with "Enabled by default" column distinguishing auto-loaded vs
  CREATE EXTENSION required
- Add categorized descriptions with SQL examples for all 11 extensions:
  pgvector, PostGIS, TimescaleDB, pg_duckdb, roaringbitmap, pg_trgm,
  pg_stat_statements, pgaudit, pg_cron, pg_partman, pglogical
- Note version availability differences: pg_duckdb not on PG12,
  roaringbitmap PG18 only, pg_duckdb 0.3.0 on PG14–PG17 vs 1.1.0 on PG18

FAQs:
- Update frontmatter description and keywords
- Add FAQ #4: how to check replication lag (pg_last_xact_replay_timestamp
  and pg_stat_replication
- Add FAQ #5: how to connect to a read replica directly via headless
  service DNS
- Add FAQ #6: automatic failover trigger conditions and sequence
- Add FAQ #7: how to adjust pgbouncer connection pool settings via
  Reconfiguring OpsRequest
EOF
)
@weicao weicao merged commit bdf4797 into main Apr 9, 2026
1 check passed
@weicao weicao deleted the docs/postgresql-overview-faqs branch April 9, 2026 03:11
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.

docs(postgresql): improve overview and expand FAQs

1 participant