docs: consolidate integration list to single source by jdx · Pull Request #541 · jdx/usage

jdx · 2026-03-13T13:25:18Z

Summary

Replaces the duplicated integration list in integrations/README.md with a link to the canonical list at https://usage.jdx.dev/spec/integrations/
Prevents the two lists from getting out of sync (as happened in docs: add argparse-usage integration #531)

Closes #535

Test plan

Verify the link resolves correctly

🤖 Generated with Claude Code

Note

Low Risk
Low risk documentation-only change that removes a duplicated list and adds an external link; main risk is link correctness/availability.

Overview
Removes the long, duplicated checklist of planned/available integrations from integrations/README.md and replaces it with a single link to the canonical Integrations documentation page to keep the list in one place.

^{Written by Cursor Bugbot for commit d7f26ee. This will update automatically on new commits. Configure here.}

Replace the duplicated integration list in integrations/README.md with a link to the canonical list in the docs site. Co-Authored-By: Claude Opus 4.6 <[email protected]>

gemini-code-assist · 2026-03-13T13:25:30Z

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request streamlines the management of the project's integration list by eliminating a redundant, manually maintained list within the integrations/README.md file. By directing users to a single, authoritative source for integration information, it ensures accuracy and consistency across documentation, preventing discrepancies that could arise from multiple, unsynchronized lists.

Highlights

Integration List Consolidation: The duplicated integration list in integrations/README.md has been removed.
Canonical Source Link: A link to the official, canonical integration list at https://usage.jdx.dev/spec/integrations/ has been added.
Preventing Sync Issues: This change prevents future inconsistencies between the local README and the canonical list, addressing a previous issue (docs: add argparse-usage integration #531).

Changelog

integrations/README.md
- Removed the extensive "Status" section detailing various integrations and their priorities.
- Added a concise link directing users to the external, canonical "Integrations documentation" for the full list.

Activity

The pull request addresses and closes issue Two copies of the integration list #535.
A test plan was provided to verify the correctness of the new link.
The pull request was generated with Claude Code.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This pull request is a great step towards improving documentation maintainability by consolidating the list of integrations into a single, canonical source. I have one suggestion to slightly improve the structure of the updated README file.

gemini-code-assist · 2026-03-13T13:26:07Z

- [ ] **OptionParser** (Elixir) - stdlib
- [ ] **OptionParser** (Ruby) - stdlib
- [ ] **getopt** (C) - POSIX stdlib
+For the full list of available and planned integrations, see the [Integrations documentation](https://usage.jdx.dev/spec/integrations/).


To maintain the document's structure and improve readability, consider reintroducing the ## Status heading that was present before. This makes it clear that this section is about the integration status, with the details now available via the link.

Suggested change

For the full list of available and planned integrations, see the [Integrations documentation](https://usage.jdx.dev/spec/integrations/).

## Status

For the full list of available and planned integrations, see the [Integrations documentation](https://usage.jdx.dev/spec/integrations/).

greptile-apps · 2026-03-13T13:26:29Z

Greptile Summary

This PR consolidates the integration list to a single source of truth by removing the duplicated (and slightly stale) list from integrations/README.md and replacing it with a link to the canonical https://usage.jdx.dev/spec/integrations/ page, which is backed by docs/spec/integrations.md. The canonical page is already more up-to-date — it correctly lists argparse (Python) and OptionParser (Ruby) as "Available" integrations, whereas the old README still had them unchecked under "Lower Priority".

Removes 42 lines of duplicated content from integrations/README.md
Adds a single-line pointer to the canonical documentation
Prevents future drift between the two lists (as occurred in docs: add argparse-usage integration #531)
No code logic changes; documentation only

Confidence Score: 5/5

This PR is safe to merge — it is a documentation-only change with no code logic affected.
The change removes a duplicated and slightly stale integration list and replaces it with a link to the canonical docs page. The target file (docs/spec/integrations.md) exists in the repository and is more complete than the removed content. There are no code changes, no API contract changes, and no risk of runtime breakage.
No files require special attention.

Important Files Changed

Filename	Overview
integrations/README.md	Removes the duplicated integration list and replaces it with a link to the canonical docs at https://usage.jdx.dev/spec/integrations/; the target page (docs/spec/integrations.md) exists and is more up-to-date than what was removed.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["integrations/README.md\n(source of truth removed)"] -->|"replaced with link to"| B["https://usage.jdx.dev/spec/integrations/\n(canonical list)"]
    C["docs/spec/integrations.md\n(source file)"] -->|"rendered as"| B
    B --> D["Available Integrations\n(clap, Cobra, argparse, OptionParser)"]
    B --> E["Planned Integrations\n(High / Medium / Lower priority)"]

_{Last reviewed commit: d7f26ee}

Copilot

Pull request overview

Consolidates the integrations list by removing the duplicated table in integrations/README.md and pointing readers to the canonical integrations list on the documentation site, reducing the chance of the two lists drifting out of sync (per #535 / #531).

Changes:

Removed the in-repo duplicated integrations “Status / Priority” list from integrations/README.md.
Added a single link to the canonical integrations documentation page (https://usage.jdx.dev/spec/integrations/).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

codecov · 2026-03-13T13:30:06Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.94%. Comparing base (15a13d3) to head (d7f26ee).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #541   +/-   ##
=======================================
  Coverage   77.94%   77.94%           
=======================================
  Files          48       48           
  Lines        6682     6682           
  Branches     6682     6682           
=======================================
  Hits         5208     5208           
  Misses       1114     1114           
  Partials      360      360

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@jdx

⚠️ **CAUTION: this is a major update, indicating a breaking change!** ⚠️ This MR contains the following updates: | Package | Update | Change | |---|---|---| | [usage](https://github.com/jdx/usage) | major | `2.18.2` → `3.2.0` | MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot). **Proposed changes to behavior should be submitted there as MRs.** --- ### Release Notes <details> <summary>jdx/usage (usage)</summary> ### [`v3.2.0`](https://github.com/jdx/usage/blob/HEAD/CHANGELOG.md#320---2026-03-23) [Compare Source](jdx/usage@v3.1.0...v3.2.0) ##### 🚀 Features - Support env-backed choices with `choices env=...` by [@mustafa0x](https://github.com/mustafa0x) in [#548](jdx/usage#548) ##### 🐛 Bug Fixes - **(zsh)** escape parentheses and brackets in completion descriptions by [@jdx](https://github.com/jdx) in [#559](jdx/usage#559) ##### New Contributors - [@mustafa0x](https://github.com/mustafa0x) made their first contribution in [#548](jdx/usage#548) ### [`v3.1.0`](https://github.com/jdx/usage/blob/HEAD/CHANGELOG.md#310---2026-03-22) [Compare Source](jdx/usage@v3.0.0...v3.1.0) ##### 🚀 Features - **(cli)** render all doc-related fields in --help output by [@jdx](https://github.com/jdx) in [#554](jdx/usage#554) - **(cli)** support reading spec from stdin via --file - by [@jdx](https://github.com/jdx) in [#555](jdx/usage#555) ##### 🐛 Bug Fixes - **(zsh)** remove trailing space from completions and add directory slash by [@jdx](https://github.com/jdx) in [#556](jdx/usage#556) - use field assignment for non-exhaustive Spec in benchmarks by [@jdx](https://github.com/jdx) in [#552](jdx/usage#552) ##### 📦️ Dependency Updates - update apple-actions/import-codesign-certs digest to [`fe74d46`](jdx/usage@fe74d46) by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#550](jdx/usage#550) - update codecov/codecov-action digest to [`1af5884`](jdx/usage@1af5884) by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#551](jdx/usage#551) - lock file maintenance by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#547](jdx/usage#547) ### [`v3.0.0`](https://github.com/jdx/usage/blob/HEAD/CHANGELOG.md#300---2026-03-13) [Compare Source](jdx/usage@v2.18.2...v3.0.0) ##### 🚀 Features - **(spec)** **breaking** add support for license, before/after help metadata by [@jdx](https://github.com/jdx) in [#542](jdx/usage#542) ##### 🐛 Bug Fixes - **(cobra)** escape newlines, tabs, and carriage returns in kdlQuoteAlways by [@thecodesmith](https://github.com/thecodesmith) in [#539](jdx/usage#539) - bump major version for breaking changes in release automation by [@jdx](https://github.com/jdx) in [#544](jdx/usage#544) - add custom\_major\_increment\_regex for breaking change detection by [@jdx](https://github.com/jdx) in [#545](jdx/usage#545) - handle all breaking change commit formats in major bump regex by [@jdx](https://github.com/jdx) in [27e1ab1](jdx/usage@27e1ab1) - normalize breaking change commit format in preprocessor by [@jdx](https://github.com/jdx) in [aa72b92](jdx/usage@aa72b92) ##### 📚 Documentation - add argparse-usage integration by [@jdx](https://github.com/jdx) in [#531](jdx/usage#531) - mark KDL code blocks as KDL and use correct inline-comment `//` by [@muzimuzhi](https://github.com/muzimuzhi) in [#536](jdx/usage#536) - fix include syntax to match implementation by [@jdx](https://github.com/jdx) in [#540](jdx/usage#540) - consolidate integration list to single source by [@jdx](https://github.com/jdx) in [#541](jdx/usage#541) - fix link to integrations by [@muzimuzhi](https://github.com/muzimuzhi) in [#543](jdx/usage#543) ##### 🛡️ Security - **(deps)** update dependency eslint to v10 by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#526](jdx/usage#526) ##### 🔍 Other Changes - Added an integration with ruby's OptionParser by [@packrat386](https://github.com/packrat386) in [#533](jdx/usage#533) ##### 📦️ Dependency Updates - update actions/setup-node digest to [`53b8394`](jdx/usage@53b8394) by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#525](jdx/usage#525) - update jdx/mise-action action to v3 by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#528](jdx/usage#528) - update rust crate roff to v1 by [@renovate\[bot\]](https://github.com/renovate\[bot]) in [#529](jdx/usage#529) ##### New Contributors - [@thecodesmith](https://github.com/thecodesmith) made their first contribution in [#539](jdx/usage#539) - [@packrat386](https://github.com/packrat386) made their first contribution in [#533](jdx/usage#533) </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this MR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this MR, check this box --- This MR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).

docs: consolidate integration list to single source (#535)

d7f26ee

Replace the duplicated integration list in integrations/README.md with a link to the canonical list in the docs site. Co-Authored-By: Claude Opus 4.6 <[email protected]>

Copilot AI review requested due to automatic review settings March 13, 2026 13:25

Copilot started reviewing on behalf of jdx March 13, 2026 13:25 View session

gemini-code-assist Bot reviewed Mar 13, 2026

View reviewed changes

Copilot AI reviewed Mar 13, 2026

View reviewed changes

jdx merged commit 47f017a into main Mar 13, 2026
14 checks passed

jdx deleted the fix/535-integration-list branch March 13, 2026 13:27

mise-en-dev mentioned this pull request Mar 13, 2026

chore: release v3.0.0 #527

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: consolidate integration list to single source#541

docs: consolidate integration list to single source#541
jdx merged 1 commit intomainfrom
fix/535-integration-list

jdx commented Mar 13, 2026 •

edited by cursor Bot

Loading

Uh oh!

gemini-code-assist Bot commented Mar 13, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

gemini-code-assist Bot Mar 13, 2026

Uh oh!

greptile-apps Bot commented Mar 13, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

codecov Bot commented Mar 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

jdx commented Mar 13, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

gemini-code-assist Bot commented Mar 13, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist Bot Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot commented Mar 13, 2026

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Flowchart

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

codecov Bot commented Mar 13, 2026

Codecov Report

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jdx commented Mar 13, 2026 •

edited by cursor Bot

Loading