How to Create a User Story

Updated 1 month ago by Copado Solutions

A user story is an element used in Agile software development that contains a short, simple and complete description of a task that needs to be completed by a user. In Copado, user stories are used to move changes across your pipeline.

Let’s take a look at the step-by-step process of creating a user story:

  1. Navigate to the User Stories tab and click on New at the top right corner of the page.
    You can also create a user story from the User Stories related list on the Project record.
  2. Select record type according to the purpose of the User Story. Here are the details:

    Record Type

    Purpose of the User Story

    User Story

    To design or work on a feature.

    Bug

    To fix a bug.

    Investigation

    To investigate an issue (but not to actually fix it) or a feature.

    Utility

    To create a User Story Bundle.


    In this example, use the record type as User Story:
  3. Fill in the Information section:
    1. Provide a title for your user story. The title should include a short description of the requirements of the user story.
    2. Select a project. If you select a sprint but not a project, Copado will automatically set the Project lookup field to the project referenced in the selected sprint.
    3. Select the release in which the user story will be included.
    4. Choose a sprint.
    5. If you are working with themes and epics, you can include them in the user story.
    6. Select the credential of the environment where the changes you want to commit are located.
      Once you save the user story, you can easily navigate to the org to review the changes by clicking on the Open Org button (available in the User Story and Bug record types).
    7. The environment will be autopopulated based on the credential selected.
    8. If you set the Ready to Promote checkbox to true, you will make the user story eligible for promotion.
    9. If you set the Promote and Deploy checkbox to true, you will trigger a new Promotion record for that user story which will be executed immediately.
  4. Fill in the Agile content section with relevant information about what you want to accomplish with the user story:
    1. As a: Type of user or role. Persona for whom you are creating the user story.
    2. Want to: Goal (what the persona specified in the previous  field wants to achieve).
    3. So that: Reason (what the benefit of the feature requested is for the persona).
  5. Add detailed functional information about how the feature you are working on as part of the user story should work and technical information with specific details about what you are building and how you are going to implement it.
  6. Select the developer who will be working on the user story and a business analyst.
  7. Once you have filled in all the relevant fields, click on Save.

For more information about user stories, check out the articles User Story Overview and Relevant Fields on a User Story.


How did we do?