Skip to content

docs(profile): qualify Geoconnex bundling as feature-gated#3917

Merged
jqnatividad merged 1 commit into
masterfrom
fix-profile-docs-geoconnex-feature-gate
May 28, 2026
Merged

docs(profile): qualify Geoconnex bundling as feature-gated#3917
jqnatividad merged 1 commit into
masterfrom
fix-profile-docs-geoconnex-feature-gate

Conversation

@jqnatividad
Copy link
Copy Markdown
Collaborator

Summary

Follow-up to commit 27cf47441 (PR-less doc commit on master). The bundled-profiles list in the profile command description claimed Geoconnex was embedded unconditionally, but the geoconnex profile is only compiled in when the geoconnex cargo feature is enabled. Builds without it (notably qsvlite and qsvmcp, and qsvdp unless built with -F datapusher_plus,geoconnex) cannot accept --profile geoconnex.

This PR closes the doc/reality gap in three files and uses the help generator so they stay in sync.

Changes

  • README.md (single source of truth): reworded the profile row from "...Croissant 1.1 and Geoconnex profiles bundled" to "...Croissant 1.1 bundled; Geoconnex when built with the geoconnex feature".
  • docs/help/TableOfContents.md and docs/help/profile.md: regenerated via qsv --generate-help-md (per CLAUDE.md, these files must never be hand-edited — the generator reads the README command table).

Roborev

Closes local roborev review #2573 (Low). The reviewer flagged this exact discrepancy and suggested the wording adopted here.

Test plan

  • cargo build --bin qsv -F all_features — clean
  • qsv --generate-help-md — generator regenerated docs/help/TableOfContents.md and docs/help/profile.md from the updated README.md row
  • Visual diff: all three files now consistent ("Geoconnex when built with the geoconnex feature")
  • No tests needed — pure docs change

🤖 Generated with Claude Code

…2573)

Roborev #2573 (Low): the bundled-profiles list claimed Geoconnex was
embedded unconditionally, but the geoconnex profile is only compiled
in when the `geoconnex` cargo feature is enabled — builds without it
(notably qsvlite / qsvmcp, and qsvdp unless built with
`-F datapusher_plus,geoconnex`) cannot accept `--profile geoconnex`.

Updated README.md (the source of truth) to read "...DCAT-AP v3 and
Croissant 1.1 bundled; Geoconnex when built with the `geoconnex`
feature" and ran `qsv --generate-help-md` to regenerate the auto-
generated `docs/help/TableOfContents.md` and `docs/help/profile.md`
counterparts.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@codacy-production
Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@jqnatividad jqnatividad merged commit 332d0cf into master May 28, 2026
19 checks passed
@jqnatividad jqnatividad deleted the fix-profile-docs-geoconnex-feature-gate branch May 28, 2026 04:04
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