Page MenuHomeSoftware Heritage

Create user personas to clarify who are the users reading the documentation
Open, NormalPublic


A summary from the following article to create SWH user personas to help with writing clear documentation.

  1. User Group—This typically designates the role of a particular type of user—for instance, Laboratory Manager.
  2. User Name—This should be a fictional name.
  3. Job Details—Indicate the persona’s primary role and responsibilities.
  4. Demographic Data—You might include the persona’s age, academic and professional qualifications, ethnicity, and family status.
  5. Goal—What is the customer trying to achieve by using your product?
  6. Tasks/Actions—What tasks would this persona perform using your product, how, and in what order? How long would it take to complete these tasks?
  7. Aspirations & Values—What is of primary importance to this persona? What values drive this persona’s purchasing decisions? Would emotions, logic, or impulse shopping influence these purchasing decisions? Would this persona perceive the product as utilitarian or aspirational? Does product quality or cost influence this persona more?
  8. Needs & Requirements—What answers does this persona seek? What information is necessary to accomplish the persona’s tasks and when is it needed? What are the persona’s must-haves, desirables, and value-adds?
  9. Painpoints—What would cause this persona to opt out of using the product, switch to a rival product, or abandon a process midway? Why?
  10. Expectations—How does this persona expect the product to work? What are the expectations this persona has in regard to product pricing? To what degree would this persona be tolerant of time consumption or delays? What is the persona’s mental model for this experience?
  11. Customer Journey Stage & Customer Type—Might this persona represent potential customers who are just starting their product research? Customers who are ready to make a purchase? Satisfied repeat purchasers or returning customers? Prospective switchers or loyal customers who are planning to upgrade?
  12. Emotions—What is the persona’s current emotional state? Happy, angry, anxious, disappointed, excited, or indifferent?
  13. Back Story & Quotation—Provide a short narrative and a real user quotation that sums up the key characteristics of a user need or problem.
  14. Image—Include an image that represents the particular target user group.

Event Timeline

moranegg triaged this task as Normal priority.EditedDec 16 2020, 3:19 PM
moranegg created this task.

Here is the stakeholder landscape that was created for the SCID WG output (RDA & FORCE11)