Expand Jira docs

[jpelletier1]

Please add a section to the Jira docs that explains the main use case for the integration. With the Jira integration, users can request OpenHands to read the ticket and implement the requirements, resulting in an OpenHands conversation that generates a pull request. Doing so requires the user to provide the repo location either in 1) the body of the ticket itself, or 2) within the comment.

Example ticket

Title: Add SAML Support
Body: As an administrator for my web app, I want to configure SAML so I can provide secure access to my system.

GitHub repository: AcmeCo/WebApp

AC:

• Verify an administrator can configure SAML settings
• Verify an end user can authenticate via SAML

You can then request OpenHands the following ways:

• Adding an 'openhands' label
• Using `@openhands please review these requirements, generate a plan, and then proceed with implementation'

[openhands-ai]

I'm on it! jpelletier1 can track my progress at all-hands.dev

[openhands-ai]

Final Summary

I have successfully fixed issue #427 by expanding the Jira integration documentation with the requested use case information.

✅ Completion Checklist

• Added Overview section explaining the main use case for the Jira integration
• Documented the workflow showing how OpenHands reads tickets and generates PRs
• Explained repository specification - can be provided in either:
  • The ticket body itself, or
  • A comment on the ticket
• Documented trigger methods:
  • Adding an openhands label
  • Using @openhands please review these requirements, generate a plan, and then proceed with implementation
• Included complete example ticket with:
  • Title: "Add SAML Support"
  • User story format body
  • Repository specification: GitHub repository: AcmeCo/WebApp
  • Acceptance criteria
• Applied to both documentation files:
  • Jira Cloud integration (jira-integration.mdx)
  • Jira Data Center integration (jira-dc-integration.mdx)
• Created new branch openhands/expand-jira-docs
• Committed and pushed changes with proper co-author attribution
• Opened PR Expand Jira integration docs with use case and examples #428 following the repository template and mentioning "Fixes Expand Jira docs #427"

Changes Summary

The changes are concise and focused - only adding the necessary Overview section at the beginning of each Jira integration document. No extraneous modifications were made. The new content provides clear, practical guidance to users on how to leverage the Jira integration for automated development workflows.

PR Link: #428

[openhands-ai]

@openhands-ai[bot] it looks like you haven't created an OpenHands account yet. Please sign up at OpenHands Cloud and try again.