You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[task] Convert chatops.md guide to task-oriented how-to format #1475
Refactor docs/src/content/docs/guides/chatops.md to follow the task-oriented how-to guide structure with clear prerequisites, steps, and expected outcomes.
Context
The scout report recommends that how-to guides should be focused on solving specific tasks with prerequisites listed upfront and clear step-by-step instructions. This is a pilot conversion to establish the pattern. Part of issue #1433.
Approach
Restructure the existing chatops guide to follow this template:
---title: How to Build a ChatOps Botdescription: Create a workflow that responds to slash commands in issues and pull requests---## What You'll Build
A bot that responds to `/hello` commands in issue comments.
## Prerequisites- Repository with GitHub Actions enabled
- Basic understanding of agentic workflows (complete "Your First Workflow" tutorial first)
## Steps### 1. Create the Workflow File
Create `.github/workflows/chatops-bot.md` with this content:
[complete code example]### 2. Test the Command1. Open any issue in your repository
2. Add a comment with `/hello`3. Wait 10-30 seconds
### 3. Verify the Response
You should see a comment from github-actions bot responding to your command.
## Expected Result
The bot responds to `/hello` commands with a greeting message.
## Troubleshooting**Bot doesn't respond**: Check workflow run logs in Actions tab...
## Next Steps- Learn how to add parameters to commands (link)
- Restrict bot to specific users (link)
## Related- Tutorial: Your First Workflow
- Reference: Command Triggers
Activity