Skip to content

docs: document integration search/info/scaffold subcommands (#3174)#3194

Open
Noor-ul-ain001 wants to merge 3 commits into
github:mainfrom
Noor-ul-ain001:docs/integration-search-info-scaffold
Open

docs: document integration search/info/scaffold subcommands (#3174)#3194
Noor-ul-ain001 wants to merge 3 commits into
github:mainfrom
Noor-ul-ain001:docs/integration-search-info-scaffold

Conversation

@Noor-ul-ain001

Copy link
Copy Markdown
Contributor

What

docs/reference/integrations.md documented the integration commands but omitted three subcommands that exist in code. This broke parity with the extension, preset, bundle, and workflow references, all of which document their search/info equivalents.

Fixes #3174.

Missing commands now documented

Command Code location
specify integration search [query] (--tag, --author) src/specify_cli/integrations/_query_commands.py
specify integration info <integration_id> src/specify_cli/integrations/_query_commands.py
specify integration scaffold <key> (--type) src/specify_cli/integrations/_scaffold_commands.py

How

Added three sections matching the structure used for the analogous extension/preset/bundle references:

  • Search Available Integrations and Integration Info after List Available Integrations.
  • Scaffold a New Integration after Integration-Specific Options.

All option names, the kebab-case key requirement, and the scaffold --type values (markdown default, plus skills, toml, yaml) were taken directly from the command definitions and docstrings in the source, so the docs match runtime behavior.

🤖 Generated with Claude Code

)

docs/reference/integrations.md omitted three subcommands that exist in
code, breaking parity with the extension/preset/bundle/workflow
references which all document their search/info equivalents.

Added sections for:
- `specify integration search [query]` (--tag, --author)
- `specify integration info <integration_id>`
- `specify integration scaffold <key>` (--type: markdown/skills/toml/yaml)

Content mirrors the command docstrings, arguments, and options in
src/specify_cli/integrations/_query_commands.py and _scaffold_commands.py.

Fixes github#3174.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the integration CLI reference documentation to include the previously undocumented specify integration search, specify integration info, and specify integration scaffold subcommands, restoring parity with other reference docs (extensions/presets/bundles/workflows).

Changes:

  • Documented specify integration search [query] with --tag / --author filters.
  • Documented specify integration info <integration_id> usage.
  • Documented specify integration scaffold <key> and the supported --type values.
Show a summary per file
File Description
docs/reference/integrations.md Adds reference sections for integration search, integration info, and integration scaffold.

Review details

Tip

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

  • Files reviewed: 1/1 changed files
  • Comments generated: 2
  • Review effort level: Low

Comment thread docs/reference/integrations.md Outdated
Comment thread docs/reference/integrations.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Low

Comment thread docs/reference/integrations.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 1/1 changed files
  • Comments generated: 0 new
  • Review effort level: Low

@Noor-ul-ain001

Copy link
Copy Markdown
Contributor Author

@mnriem requested changes has been implemented.
Kindly review. Thanks

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.

Docs: integration reference missing search, info, and scaffold subcommands

3 participants