Polifonia Stories

This is a shared common space to share stories for the Polifonia project. A story is a template for collecting requirements.

A story is composed of:

• Persona
  • It is a research-based description of a typical user.
  • It contains attributes such as name, age, occupation, and relevant characteristics of the person such as their knowledge and skills and their interests.
•  Goal
  • It is a short description of the goal, the need, the task the Persona needs to address.
  • The goal is also represented by a short (maximum 5) list of keywords.
• Scenario
  • It is a story of how the persona’s task/need/problem is solved before, during and after interaction with the resource/software/service being developed.
• Competency questions (CQs)
  • Question(s) the persona needs the resource/software/service to answer for satisfying their task/need/problem.

How to create a story

There is one folder for each Persona, named with the name of the Persona and their primary occupation.

1. Check all existing Personas, in order to see if there is already the Persona you need for your story. You will find a readme file in each folder, describing the Persona.
2. If you find a Persona that suits you, create a new file in the respective folder, named “name-of-the-persona#progressive-number”, and fill the file with your story, following this example.
3. If not, create a new folder, named "name-of-the-persona: primary-occupation", and create a readme file describing the persona (see this example), and then a file with your story as this example.
4. Besides providing information about the four components of the story, you should additionally fill in a table with this information:

• id (name-of-the-persona#progressive-number)
• persona (name of the persona)
• Keywords (representing their goals)
• WP (WPs involved in the story)
• Pilots (pilots involved in the story)
• Priority (based on a “wow” scale, choosing from “must have”, "nice to have", “great to have”)

List of personas

• (add personas here)
• Sethus: Music Theorist
• Carolina: Music Historian

List of stories

• (add stories here)
• Sethus#1
• Carolina#1

Useful links

GitHub guides:

• Index https://guides.github.com/
• Markdown https://guides.github.com/features/mastering-markdown/
• Markdown cheatsheet: https://www.markdownguide.org/cheat-sheet/