Note Step

Add inline documentation to RiskOS™ workflows using Note steps to explain logic, highlight decisions, and support team collaboration.

The Note step adds inline documentation directly to your workflow. It does not affect execution or evaluation outcomes — it provides context and supports collaboration.


When to use Notes

  • Explain logic: Document why certain rules, conditions, or enrichments exist.
  • Highlight key decisions: Call out business logic or thresholds important for reviewers.
  • Collaborate: Share feedback, ask questions, or suggest changes while designing workflows.
  • Track assumptions: Record considerations or limitations relevant to the workflow’s design.

Configure a Note step

  1. Right-click anywhere on the workflow canvas to open the step menu.
  2. Select Note.
  3. Enter your text in the side panel.
  4. Save the workflow.
📘

Note:

  • Notes are visible when reviewing the workflow in the UI but are not included in API responses.
  • You can edit or delete notes at any time without affecting workflow behavior.

Best practices

  • Keep notes concise: Summarize logic or intent in a few clear sentences.
  • Use consistent language: Write so both technical and non-technical stakeholders can understand.
  • Update regularly: Revise notes as workflows evolve to keep them accurate.
  • Avoid sensitive data: Never include personally identifiable information (PII) or secrets in notes.