Skip to content

[style-harmonize] generalize CONFIG GET to engine-neutral runtime readback in reconfigure-version-skew#48

Merged
weicao merged 1 commit intomainfrom
style-harmonize/reconfigure-skew-engine-neutral-readback
May 3, 2026
Merged

[style-harmonize] generalize CONFIG GET to engine-neutral runtime readback in reconfigure-version-skew#48
weicao merged 1 commit intomainfrom
style-harmonize/reconfigure-skew-engine-neutral-readback

Conversation

@weicao
Copy link
Copy Markdown
Contributor

@weicao weicao commented May 3, 2026

Summary

Closes James's post-merge review on PR #47 (comment 4367296663): CONFIG GET is Redis/Valkey-specific but the silent-regression detection methodology should be cross-engine.

Adds engine-neutral runtime readback command table in chapter 5 showing the readback command per engine:

Engine Readback
Valkey / Redis CONFIG GET
MariaDB / MySQL SHOW VARIABLES / SELECT @@param
PostgreSQL SHOW / current_setting
Oracle SHOW PARAMETER / v$parameter
SQL Server sys.configurations / sp_configure
OceanBase __all_sys_parameter

Plus generalizes 3 strategic mentions in chapter 1 / 2 / 5 from CONFIG GET to engine runtime readback (e.g. CONFIG GET / v$parameter / SHOW VARIABLES) style.

Why this matters

addon-reconfigure-version-skew-guide claims cross-version applicability for "任何在 KB 多个发布带之间复用的 addon" but body only used Redis-specific examples. Per westonnnn cross-engine usage annotation convention (msg=ea854a7a / 8c0b2e62), parent doc must surface engine-specific examples for all engines that the methodology applies to, not just one.

This is also a Cat-5 ROI instance (per Helen / Kevin discussion): doc-as-discovery-vector for engine-specific assumption — James (Oracle TL) noticed and flagged within minutes of PR #47 merge.

Out of scope (deliberately not modified)

  • Trap T4 'CONFIG SET silent +OK': kept Redis/Valkey-specific because it's a genuine engine-specific behavior (Redis returns +OK for deprecated alias / out-of-range enum but doesn't apply), not a generalization candidate
  • Chapter 7/8 specific examples: CONFIG GET mentions in case-specific examples / test matrices left as engine-specific examples

Test plan

  • New chapter 5 sub-section table renders cleanly with all 6 engine rows
  • 3 strategic generalizations (chapter 1 / 2 / 5) read engine-neutral
  • Body content unchanged outside the 4 spots
  • cross-engine annotation convention applied (parent doc shows multi-engine examples)

…dback in reconfigure-version-skew

James (Oracle TL) post-merge review on PR #47 (commit 4367296663):
'CONFIG GET' is Redis/Valkey-specific, but the silent regression
detection methodology should be cross-engine. Suggested generalization
to 'engine-specific runtime readback' with engine examples.

This fixup adds an engine-neutral readback command table in chapter 5
showing the runtime readback command/source per engine:

- Valkey / Redis: CONFIG GET
- MariaDB / MySQL: SHOW VARIABLES / SELECT @@param
- PostgreSQL: SHOW / current_setting / pg_reload_conf
- Oracle: SHOW PARAMETER / v$parameter
- SQL Server: sys.configurations / sp_configure
- OceanBase: __all_sys_parameter / SHOW PARAMETERS

Plus generalizes 3 strategic mentions from 'CONFIG GET' to 'engine
readback (e.g. CONFIG GET / v$parameter / SHOW VARIABLES)' style:

- chapter 1 silent regression definition (line 40)
- chapter 2 KB version inference clue (line 85)
- chapter 5 actionable verification rule (line 156)

Trap T4 'CONFIG SET silent +OK' kept as Redis/Valkey-specific
because it's a genuine engine-specific behavior, not a generalization
candidate. Other CONFIG GET mentions in chapter 7/8 left because
they appear in Redis/Valkey-specific examples / test matrices.

This is exactly the cross-engine generalization westonnnn requested
to be visible in parent docs (msg=ea854a7a / 8c0b2e62 cross-engine
usage annotation convention).
@weicao weicao merged commit aea5295 into main May 3, 2026
weicao added a commit that referenced this pull request May 3, 2026
…adback in PR #48 (#49)

Brings SKILL-INDEX line 79 entry into consistency with parent doc body engine-neutral readback table after PR #48. Single-line edit per Alice msg=9de1a5fd post-merge follow-up.
weicao added a commit that referenced this pull request May 4, 2026
…ection (#52)

Closes 6 nits across PR #50 + #51 (Fix validation sub-section abstracts / 设计教训 anti-pattern statements / Guard v1 strength progression abstracts / Source evidence index cross-repo path prefix) + adds new SKILL-INDEX ### OceanBase section with 2 case entries closing the cases/oceanbase/-to-SKILL-INDEX sync gap. Pure additive; methodology body unchanged. Same retrofit pattern as PR #29/#35/#41/#45/#48/#49.
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.

1 participant