# User Journeys & Acceptance Criteria in Flowriter

Flowriter automatically writes documentation based on the content and logic in a Story's flowchart. It produces these documents:

1. User Journeys, and
2. Acceptance Criteria.

## User Journeys

User Journeys outline the steps and decisions users make to achieve their goals, and inform the Acceptance Criteria. 

Flowriter analyzes and assesses all possible paths that a user or system may take when interacting with the feature, based on the flowchart structure to produce the User Journeys:

<figure><img src="/files/zNngz1YuWHQArAI6fM96" alt=""><figcaption></figcaption></figure>

User Journey mapping is important. It helps the feature owner understand if all possible tasks that a user or system need to complete are considered in the documentation. They are also useful for preparing Test Plans to ensure that the final feature implementation is correct and has full test coverage.

## Acceptance Criteria

A Story's Acceptance Criteria is automatically generated, and consists of two (2) parts:

* Role, Goal, and Benefit statement
* Gherkin -style Scenarios within an overall Feature statement

<figure><img src="/files/qmwQHLZhVEaXYyKBk6RV" alt="" width="563"><figcaption></figcaption></figure>

#### Role, Goal, and Benefit statement

This summarizes the overall feature described in the flowchart and identified User Journeys, and is presented in this format:&#x20;

`As a [user/system/...] ... I want to ... So that ...`&#x20;

#### Gherkin -style Feature/Scenario statements

These defines how the feature should behave based on User Journeys. These criteria are generated in [Gherkin](https://cucumber.io/docs/terms/user-story/), a structured format that can be read by both humans and scripts.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://candesce.gitbook.io/flowriter/generate-acceptance-criteria/user-journeys-and-acceptance-criteria-in-flowriter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.