Skip to content

Conversation

@NikolayS
Copy link
Owner

@NikolayS NikolayS commented Nov 5, 2025

  • Fix grammar in README.md: "incomplete list" → "an incomplete list"
  • Improve README.md formatting for better readability
  • Fix shell script formatting in generate.sh (add missing space)
  • Update PostgreSQL terminology: "master" → "primary" in all SQL files
  • Fix typos in SQL comments: "inspect" → "inspects", "Vaccuum" → "Vacuum"
  • Remove duplicate random_page_cost entry in t1_tuning.sql
  • Remove redundant CTE in i2_redundant_indexes.sql
  • Regenerate start.psql file with updated changes

Documentation improvements:
- Fix grammar in README.md ("an incomplete list")
- Improve README.md formatting for better readability

Code quality improvements:
- Fix shell script formatting in generate.sh (spacing)
- Update terminology: "master" → "primary" throughout SQL files
- Fix typos: "inspect" → "inspects", "Vaccuum" → "Vacuum"
- Remove duplicate random_page_cost entry in t1_tuning.sql
- Remove redundant CTE in i2_redundant_indexes.sql
- Regenerate start.psql with updated changes

These changes improve code consistency and align with modern
PostgreSQL terminology while maintaining backward compatibility.
@NikolayS NikolayS force-pushed the claude/polish-codebase-011CUqdAcdCrkXdiTHDz9zft branch from bb9c89b to f852239 Compare November 5, 2025 23:44
Code quality improvements:
- Fix typos in b2_btree_estimation.sql:
  - "inspect" → "inspects"
  - "filed" → "fields"
  - "fractionnal" → "fractional"
  - "functionnal" → "functional"
- Fix typo in p1_alignment_padding.sql: "alt_shits" → "alt_shifts"
- Improve comment readability in s2_pg_stat_statements_report.sql:
  - Add space after "--" for consistency
  - "format" → "formatting" for grammatical correctness

These changes improve code documentation and fix embarrassing typos
that could confuse developers reading the codebase.
Code improvements:
- Fix alter_user script to use 'raise info' instead of 'raise debug'
  for consistency with create_user script
- Fix inverted logic in refresh_all.sql notice message:
  - Change TRUE to FALSE for correct instruction
  - Replace "w/o" with "without" for better readability
- Remove duplicate 'sum(calls) as calls' in s1_pg_stat_statements_top_total.sql
  that was defined both globally and in the \else block

These changes fix functional issues and improve code clarity.
Code quality improvements:
- Standardize comment formatting to include space after "--":
  - b3_table_pgstattuple.sql: Fix 4 comment lines
  - b4_btree_pgstattuple.sql: Fix 4 comment lines
  - l1_lock_trees.sql: Fix inline comment
  - v2_autovacuum_progress_and_queue.sql: Fix inline comment

Bug fix:
- l2_lock_trees.sql: Add ELSE clause to CASE statement to prevent
  NULL concatenation when level = 1, which would make the entire
  format() result NULL

These changes ensure consistent comment formatting across SQL files
and fix a subtle bug that could cause query results to be NULL.
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.

3 participants