RabbinatixDocs
Sign inGet started

Example

Write a refund journey as text and get it approved

Typing is faster than drawing. Write the refund journey as a few lines of text and the whiteboard draws it. Then send it to a lead and an architect for approval, answer their request for changes, and publish it for the whole organization.

You will build

  • A whiteboard drawn from text
  • A review round: changes asked, fixed, approved
  • A published whiteboard everyone can see

You need two other members to approve, for example a developer lead and an architect.

Part 1: Write it as text

Each line is a step. A line ending in ? is a question; the indented lines under it are its answers (Yes -> next step). Kind: at the start picks a shape, and // adds a note.

  1. 1.

    Open Whiteboards → New whiteboard. Set Start from to Text and type:

    Start: Customer asks for a refund
    Screen: Refund form
    Pick the order and the reason
    Order older than 30 days?
      Yes -> End: Refund refused, show the policy
      No ->
    Item returned?
      No -> Wait: Customer sends the item back  // label printed in the app
        -> Item returned?
      Yes -> System: Payments refunds the card
        -> Send the refund email
        -> End: Money back in 5 working days
  2. 2.

    Name it Refund request and click Create and open.

Check: The whiteboard is drawn and laid out. A problem in the text (a broken indent, an answer with no question) is listed under the box before you create it.

Part 2: Send it for approval

  1. 1.

    Click Submit for approval…. Keep Needs approval.

  2. 2.

    Under Approvers, add the developer lead and the architect. Keep Approved when on All approvers approve. Click Submit.

Check: The status reads In review. The two approvers can now see it; it waits in their For my review tab.

Part 3: Answer a request for changes

Done by an approver, then by you.

  1. 1.

    As the architect: open it from For my review, open the side panel’s Review tab, write the Comment Refunds over 500 need a manager first and click Ask for changes.

  2. 2.

    As you: the banner shows the comment. Click Edit, add a Decision Over 500? before the refund, with Yes -> Wait: Manager approves and No going on to Payments refunds the card. Click Done.

  3. 3.

    Click Resubmit… and Submit.

Part 4: Approve and publish

  1. 1.

    As each approver: open it, click Show changes to see what moved since their review, then Approve.

  2. 2.

    When both have approved, the status reads Approved. Click Publish.

Check: The status reads Published and the whiteboard is in everyone’s Published tab.