How to Create a User Story

Updated 6 months ago by Copado Solutions

User stories are located in Copado Change Management. You can access this feature directly via the User Stories tab, or from a project by clicking on the User Stories section within the related list of the project.

To create a new user story follow the steps below:

  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 the appropriate record type. The available options are:
    1. Bug: Select this type if the goal of the user story is to fix a bug.
    2. Investigation: Select this type if the purpose of the user story is to investigate an issue (but not to actually fix it) or a feature.
    3. User Story: Select this type if the user story is aimed at designing or working on a feature.

In this example, we will use the User Story type:

  1. 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 org credential of the environment where the changes you want to commit are located.
    7. The environment will be autopopulated based on the org 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.
  2. 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).
  3. 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.
  4. Select the developer who will be working on the user story and a business analyst.
  5. 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 in a User Story.

How did we do?