docs/config-params-guc-list is incomplete

Open Beginner friendly
#369 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
postgresql

Research direction

Start with docs/config-params-guc-list and compare its entries with the parameters named in the issue and the documentation references. Check which PostgreSQL and Cloudberry-specific parameters belong in the list, then update the documentation so all confirmed useful parameters are represented.

Written by the indexing model from the issue text.

Description

Hi!

My colleagues and I was writing user-facing documentation, and we found out that docs/config-params-guc-list is incomplete. Many useful parameters are not documented.

List of parameters that referenced in docs, but not in guc-list:

  • gp_cached_segworkers_threshold
  • lock_timeout
  • max_slot_wal_keep_size
  • log_*

List of useful parameters with no mentioning in Cloudberry documentation:

  • gp_add_column_inherits_table_setting
  • gp_max_plan_size
  • gp_max_slices
  • gp_resource_group_memory_limit
  • master_shared_buffers
  • max_locks_per_transaction
  • segment_shared_buffers

For some of them - are just Postgres GUCs, some - Cloudberry-specific.

Dominant language
TypeScript
Stars
26
Forks
43
Avg merge
3d 19h
Merged PRs (30d)
4

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from apache/cloudberry-site

All issues in apache/cloudberry-site

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.