[SEC-31367] Document Ticket Creation Rules for Automation Pipelines#36851
Conversation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This comment has been minimized.
This comment has been minimized.
alex147
left a comment
There was a problem hiding this comment.
LGTM, just a single sentence that I find a bit confusing.
janine-c
left a comment
There was a problem hiding this comment.
Looks great! I made some suggestions about things like writing style and content ordering, and in one case some additional steps we might want to add, but nothing that's a big blocker 🙂 Feel free to ping me for any questions, any help implementing any of this, or for any additional review!
|
|
||
| Tickets created by a rule are marked with a lightning bolt indicator in the findings side panel and explorer views. Hovering over the indicator shows the automation rule responsible for the ticket and provides a link to the rule. | ||
|
|
||
| ## Rule matching order |
There was a problem hiding this comment.
If you wanted to, I think you could put these sections as subsections in the intro. I think it's helpful for users when they're deciding if they want to use a feature to get the nuance of how it works, and it helps if they can expect conceptual information to appear in one place in the doc. It's not terrible to have it at the end, but it does feel a little more tacked on than the "this is what this thing does!" expectation users already have about overviews.
There was a problem hiding this comment.
Thanks for the suggestion, I tried restructuring with those subsections in the intro, but I'm not fully convinced it works well. Those are fairly fine-grained implementation details that most users won't need to read before getting started. The other automation pipeline pages also follow the pattern of putting procedural steps first, which keeps things consistent. I've also kept a link from the rate limit step in the creation flow to the dedicated section, so users who need the detail can jump to it. Happy to revisit if you feel strongly, but I'd lean toward keeping the current structure.
Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com>
What does this PR do? What is the motivation?
Adds documentation for the new Ticket Creation Rules feature in Automation Pipelines (SEC-27479).
content/en/security/automation_pipelines/create_ticket.mddocumenting how to create, test, and manage ticket creation rules for Jira and Case Management_index.mdto add the new page tofurther_readingand add a use case section for ticket creationPreview
https://docs-staging.datadoghq.com/hugo.queinnec/ticket-creation-rules/security/automation_pipelines/create_ticket/
Merge instructions
Merge readiness:
Additional notes