Skip to content

docs: make single sources of truth authoritative for remaining duplicated values - #164

Merged
id774 merged 1 commit into
masterfrom
claude/doc-ssot-cleanup-smiacl
Aug 24, 2026
Merged

docs: make single sources of truth authoritative for remaining duplicated values#164
id774 merged 1 commit into
masterfrom
claude/doc-ssot-cleanup-smiacl

Conversation

@id774

Copy link
Copy Markdown
Owner

Summary

The plugin catalogue's totals and per-status counts were already consolidated into doc/PLUGINS.md section 6 in a prior change, but several other current-derived values were still duplicated across README and the docs. This finishes that cleanup.

  • Point runtime dependency counts (README, DEPLOYMENT.md) at automatic.gemspec instead of restating "four pure-Ruby gems".
  • Point the continuously validated Ruby set (README, DEPLOYMENT.md, REQUIREMENTS.md, RELEASING.md, CI comments) at the matrix in .github/workflows/ci.yml instead of repeating "3.3, 3.4 and 4.0".
  • Drop the framework's duplicated line-count claim in favor of BASIC_DESIGN.md/POLICY.md as the maintained responsibility boundary.
  • Replace the bundled siteinfo snapshot's stale "newest entries are from 2013" narrative (doc/PLUGINS.md and full_feed.rb comments) with behavior that doesn't depend on the snapshot's age, matching the v26.09 refresh from a newer upstream snapshot.
  • Replace hardcoded current AI model names in PLUGINS.md and AI_TUTORIAL.md examples with placeholders, since model availability is service-owned.
  • Resolve the QUICKSTART.md "two optional gems" claim against the three gems its own install steps actually use, by deriving the count from the DEPLOYMENT.md dependency table instead of stating it twice.
  • Update AI_TUTORIAL.md's "no chunking plugin" claim to reflect the new FilterLimit/FilterBatch plugins added in v26.09.
  • Remove the Status column from DEPLOYMENT.md's optional-dependency table, leaving PLUGINS.md section 6 as the single source for support status.
  • Replace remaining small-count prose ("two conventions", "three ways to set one up", step-number cross-references, etc.) with references to the actual section/table rather than a number that drifts.
  • Shorten two doc/VERSIONS v26.09 bullets that exceeded this file's own line-length guideline, without changing their content.

Gemfile, automatic.gemspec, and the GitHub Actions workflow files receive comment-only changes; no executable Ruby, YAML, or dependency declaration changed. plugins/filter/full_feed.rb also receives comment-only changes. spec/doc/plugins_catalogue_spec.rb, VERSION, lib/, assets/, config/, spec/, test/, and Rakefile are untouched.

Test plan

  • bundle exec rspec spec/doc/plugins_catalogue_spec.rb — 4 examples, 0 failures, no diff to this file
  • bundle exec rake spec — 357 examples, 0 failures
  • git diff --check — clean
  • Confirmed only the 14 intended files changed, and the gemspec/Gemfile/workflow/full_feed.rb diffs are comment-only

Generated by Claude Code

…ated values
Complete the documentation SSOT cleanup: the plugin catalogue's totals
and per-status counts were already consolidated into doc/PLUGINS.md
section 6, but several other current-derived values were still
duplicated across README and the docs.
- Point runtime dependency counts (README, DEPLOYMENT.md) at
automatic.gemspec instead of restating "four pure-Ruby gems".
- Point the continuously validated Ruby set (README, DEPLOYMENT.md,
REQUIREMENTS.md, RELEASING.md, CI comments) at the matrix in
.github/workflows/ci.yml instead of repeating "3.3, 3.4 and 4.0".
- Drop the framework's duplicated line-count claim in favor of
BASIC_DESIGN.md/POLICY.md as the maintained responsibility boundary.
- Replace the bundled siteinfo snapshot's stale "newest entries are
from 2013" narrative (doc/PLUGINS.md and full_feed.rb comments) with
behavior that doesn't depend on the snapshot's age, matching the
v26.09 refresh from a newer upstream snapshot.
- Replace hardcoded current AI model names in PLUGINS.md and
AI_TUTORIAL.md examples with placeholders, since model availability
is service-owned.
- Resolve the QUICKSTART.md "two optional gems" vs. the three gems its
own install steps actually use, by deriving the count from the
DEPLOYMENT.md dependency table instead of stating it twice.
- Update AI_TUTORIAL.md's "no chunking plugin" claim to reflect the
new FilterLimit/FilterBatch plugins added in v26.09.
- Remove the Status column from DEPLOYMENT.md's optional-dependency
table, leaving PLUGINS.md section 6 as the single source for support
status.
- Replace remaining small-count prose ("two conventions", "three ways
to set one up", step-number cross-references, etc.) with references
to the actual section/table rather than a number that drifts.
- Shorten two doc/VERSIONS v26.09 bullets that exceeded this file's own
line-length guideline, without changing their content.
Gemfile, automatic.gemspec, and the GitHub Actions workflow files
receive comment-only changes; no executable Ruby, YAML, or dependency
declaration changed. plugins/filter/full_feed.rb also receives
comment-only changes. spec/doc/plugins_catalogue_spec.rb, VERSION,
lib/, assets/, config/, spec/, test/, and Rakefile are untouched.
bundle exec rspec spec/doc/plugins_catalogue_spec.rb and bundle exec
rake spec both pass (357 examples, 0 failures).
@id774
id774 merged commit ab4fb7f into masterAug 24, 2026
8 checks passed
@id774
id774 deleted the claude/doc-ssot-cleanup-smiacl branch August 24, 2026 09:25
Sign up for freeto 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.

2 participants

@id774@claude