Skip to content

[docs] docs: Add documentation for --dependabot flag#2364

Merged
pelikhan merged 1 commit intomainfrom
docs/add-dependabot-flag-documentation-4034724dd619916c
Oct 25, 2025
Merged

[docs] docs: Add documentation for --dependabot flag#2364
pelikhan merged 1 commit intomainfrom
docs/add-dependabot-flag-documentation-4034724dd619916c

Conversation

@github-actions
Copy link
Contributor

Summary

Adds comprehensive documentation for the gh aw compile --dependabot flag that generates dependency manifests for automated security updates. This flag was previously undocumented in the user-facing CLI reference.

Changes Made

  • Added command examples showing basic and advanced usage (--dependabot, --dependabot --force)
  • Documented supported ecosystems: npm (with package.json/package-lock.json), pip (requirements.txt), and Go (go.mod)
  • Explained manifest generation behavior: intelligent merging with existing files, creation of .github/dependabot.yml
  • Listed prerequisites: npm in PATH requirement for npm package manifest generation
  • Documented constraints: cannot be used with specific workflow files or custom workflows directory

Documentation Quality

Diátaxis Framework: Correctly positioned in Reference section
GitHub Docs Style: Active voice, clear language, technical accuracy
Developer Experience: Copy-paste ready examples, prerequisites documented
Consistency: Matches existing CLI documentation structure and tone
Build Validation: All checks passed, no broken links

Related Files

  • Updated: docs/src/content/docs/tools/cli.md (CLI reference)

Test Plan

  • Documentation builds successfully (npm run build)
  • No broken links (Starlight validation passed)
  • HTML output verified with new content
  • Examples tested against actual CLI help text
  • Reviewed against source code implementation

🤖 Generated with Claude Code

AI generated by Technical Documentation Writer for GitHub Actions

This commit adds comprehensive documentation for the `gh aw compile --dependabot`
flag that was previously undocumented in the user-facing CLI reference.

Changes:
- Added command examples for --dependabot and --dependabot --force
- Documented supported package ecosystems (npm, pip, Go)
- Explained manifest file generation for each ecosystem
- Documented prerequisites (npm in PATH for npm packages)
- Added usage constraints and limitations
- Included Starlight note component for important constraints

The documentation follows the Diátaxis framework (Reference section), GitHub Docs
style guidelines, and maintains consistency with existing CLI documentation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Oct 25, 2025
@pelikhan pelikhan merged commit 8814605 into main Oct 25, 2025
4 checks passed
@pelikhan pelikhan deleted the docs/add-dependabot-flag-documentation-4034724dd619916c branch October 25, 2025 04:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant