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.
• Resources (optional)
  • List of resources (with references/links) where it is expected or known that the persona can find what she's looking for.

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, reflecting the impact that would be achieved by addressing the story, choosing from:
  • must have (i.e. it is something that is already supported in other systems, it is state of the art)
  • life improver (i.e. I would be able to make the same discovery/work in significant less time)
  • life changer (i.e. I would be able to make discoveries/works that now cannot be done or are extremely hard to do)
  • breakthrough (i.e. this would be a breakthrough in my field)

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/