# Explain your system to someone new

> Turn a scenario into a story that walks a new starter, a client or your manager through the map one step at a time, then present it or send it as a link.

A new developer joins on Monday. They need to know what talks to what, and why the email worker is the part everyone worries about, before they read any code. A diagram on a wiki won’t tell them that. A story will: it walks them through the live map one step at a time, like slides, with each step framing the parts it’s about and the load at that moment.

This walkthrough makes a story from the Black Friday scenario on the **Checkout system** map, rewrites it for a newcomer, and presents it.

## 1. Start from a saved scenario

A story can stop at moments in a scenario, so the map needs one saved. If you did [Will it survive Black Friday?](https://docs.flozu.app/walkthroughs/black-friday.md), it has one. Otherwise:

1. Open **Scenarios**, pick **Black Friday**, and choose **Save with the map**.

## 2. Draft the story

1. Open **Stories**. Because the map has a saved scenario, it offers to draft a story from it. Choose **From Black Friday**.

2. Flozu writes six steps: the whole map at the start, one for each moment worth stopping at (the Email worker getting tight, then running over, the busiest moment and the quietest), and a last step called **With more room** that shows the fixes the scenario suggests.

![The stories panel listing a Black Friday story's six steps, from the whole map at 00:00 to With more room, and the first step's card below the map with its title and words as fields, and buttons for its moment, framing and More.](https://docs.flozu.app/_astro/stories-light.BnTqS7jP_24hwb.webp)

It’s all one step to undo, and a draft to change. The **With more room** step shows the fixes on that step only: the map itself keeps its numbers.

## 3. Write it for your audience

The draft’s words say what happens. A newcomer also needs to know why it matters. Pick a step, and type straight into its card below the map: the card is what people see when you present.

For the step where the Email worker gets tight, the draft says what the numbers do. You might write instead:

> **The email worker is the first to struggle.** After every order, we send a confirmation email in the background. On a normal day this worker is already 60% busy, so a rush at midnight pushes it over within two minutes. Shoppers don’t wait for it, so they don’t notice. Their emails just arrive late.

1. Add a step of your own before the rush. Pick the first step, select **Orders API** and **Orders DB** on the canvas, then choose **Add a step**. It goes after the step you’re on, framing what’s selected.

2. Give it a title such as “Where an order goes”, and a sentence or two: “Every order goes through the Orders API, which charges the card with Stripe, then saves the order in PostgreSQL.”

3. Move steps up and down, or delete them, from their menus.

![A story step being edited: the camera framed on Orders API and Orders DB, everything else faded, and the step's card below the map reading Where an order goes, step 2 of 7.](https://docs.flozu.app/_astro/story-step-light.zgd8Agkb_Z1pVrTB.webp)

> **Tip**
>
> Good steps say one thing each. Frame one to three parts, give the step a moment when the load matters, and write the words for the person listening, not for you.

## 4. Present it

1. Choose **View** from the mode menu at the foot of the canvas. The map is now read-only, so nothing moves by accident.

2. Choose **Story**. The steps take the timeline’s place along the foot, and the camera glides to the first one.

3. Move through it with **Next** and **Back**, the arrow keys, or a presentation clicker (they send `Page Up` and `Page Down`). `Esc` leaves the story.

![A story playing: the camera framed on the email worker, outlined in yellow with its strip reading 84% Busy, with the story's steps along the foot reading Step 2 of 6, Email worker gets tight, Black Friday at 00:00.](https://docs.flozu.app/_astro/story-player-light.DuLoij-i_Z1MpUvP.webp)

Every step is the live map, not a picture, so anyone can stop and ask “what’s that?”, and you can select it and show them.

## 5. Send it

Choose **Share a link…** from the **Actions** menu. The link carries the map with its stories and saved scenarios, so whoever opens it can play the story at their own pace and save a copy. They don’t need an account.

![The Share a link popover: the link, copied, with a note that it holds the map as it is now.](https://docs.flozu.app/_astro/share-light.BNzWBMZs_Z2ki1JK.webp)

A link holds the map as it is when you make it. Change the story later, and make a new link.

## What you learned

- **A story from a scenario** gives you a first draft in one click, ordered by what happens.
- **The card is the slide.** What you type on a step is exactly what your audience reads.
- **A share link carries stories,** so the walkthrough works without you in the room.

## Next

- [Make the case for a fix](https://docs.flozu.app/walkthroughs/make-the-case.md) adds a step that compares the map before and after a change.
- [Stories](https://docs.flozu.app/guides/stories.md) covers every part of a step, and showing parts differently on one step.
- [Presenting and share links](https://docs.flozu.app/guides/presenting-and-sharing.md) covers what a link holds and what it leaves out.
