Guide
Edit Workflow Documentation
Overview
Workflow documentation serves as the authoritative guide for users executing automated browser tasks. Clear, well-annotated documentation reduces errors, prevents unintended consequences, and helps users understand critical prerequisites or gotchas. This workflow enables you to enhance existing documentation by adding warning annotations (for risky or destructive actions) and note annotations (for helpful context, tips, or business-critical information). By systematically adding these annotations, you improve documentation quality and reduce user support burden.
Before you begin
- Active user account on trybrowzer.com with permissions to edit workflow documentation
- Access to the Workflow Documentation section of trybrowzer.com
- Identification of the specific AI workflow task you want to enhance (e.g., 'Adds a new member to a team')
- Clear understanding of which steps require warning annotations and which need note annotations
Step by step
Workflow DocumentationNavigate to the Workflow Documentation section of trybrowzer.com by clicking the Workflow Documentation link in the main navigation. This takes you to the hub where all AI workflow tasks and their documentation are organized.
AI: Adds a new member to a team on trybrowzer.com by navigating to the Team section, clicking Invite Member, entering an email address, and sending the invitation.Select the specific AI workflow task you want to edit by clicking on its title or description. In this example, click on the 'AI: Adds a new member to a team on trybrowzer.com...' task to open its full documentation.
EditClick the Edit button to enter edit mode for the selected workflow's documentation. This unlocks the ability to add, modify, and remove annotations.
WarningClick the Warning button to begin adding a warning annotation. Warnings flag critical risks, destructive actions, or safety concerns that users must understand before executing a workflow step.
Add warning...Click on the 'Add warning...' textbox to focus it and prepare it for input. This textbox is where you will type the warning message that users should see.
Add warning...Type your warning message into the textbox. Be concise and direct; for example: 'This action will permanently remove the user from the team with no undo option' or 'Ensure you have team admin privileges before proceeding.'
NoteClick the Note button to begin adding a note annotation. Notes provide helpful context, tips, best practices, or supplementary information that enhance user understanding without flagging a risk.
Add note...Click on the 'Add note...' textbox to focus it and prepare it for input. This textbox is where you will type the note message.
Add note...Type your note message into the textbox. Keep it informative but concise; for example: 'The invited user must have a valid email address and will automatically join the team upon accepting the email invitation.'
Confirm it worked
- 1The workflow documentation page displays the selected AI task with the Edit button visible
- 2Warning annotation(s) appear visibly in the documentation after being added
- 3Note annotation(s) appear visibly in the documentation after being added
- 4Both warning and note text persist in the documentation after the workflow completes (confirming save)
Common issues
Keep reading
Editing Workflows | GitHub Agentic Workflows
``` ---on: issues: types: [opened]---# Issue TriageRead issue #${{ github.event.issue.number }} and add appropriate labels. `````` ---on: issues: types: [opened]---# Issue TriageRead issue #${
github.github.comBuilding Workflows — Editorial Documentation
Building Workflows — Editorial Documentation # Building Workflows¶ Workflows allow you to extend Editorial with your own commands. Each workflow is a sequence of simple steps (“actions”) that are ex
omz-software.comEditing a Workflow Process
Editing a Workflow Process [Previous](https://docs.oracle.com/cd/G30556_01/books/BPFWorkflow/c-Naming-a-Workflow-Process-Step-or-a-Process-Property-bo1290547.html) [Next](https://docs.oracle.com/cd/G
docs.oracle.comContributors