Page MenuHomePhabricator

Who are the target users of our documentation
Closed, ResolvedPublic

Description

Story: As a writer of documentation, I easily forget (or are unsure about) what kind of person will read the documentation

Problem: We don’t have any help in place to clarify the target readers and/or to make oneself aware of it.

Possible Solutions: Create some personas/reader profiles. We could take existing Wikidata Personas, however, they are focused on software, not documentation. Also, people might want to be part of creating the personas themselves (without original research it is more a proto-persona, but anyway). Suggestion:

  • Take Wikidata personas as example
  • Do a 30min Persona creation session
  • Define for the docs to be written which personas would need to use them

Event Timeline

The 5 current main personas used by the Wikidata team (under construction! may need refinement!) are

  • an active editor on Wikidata
  • an occasional Wikidata editor
  • an active editor on a larger Wikipedia
  • an active editor on a small Wikipedia
  • a data (re-)user working for a small startup

The 5 current main personas used by the Wikidata team (under construction! may need refinement!) are

  • an active editor on Wikidata
  • an occasional Wikidata editor
  • an active editor on a larger Wikipedia
  • an active editor on a small Wikipedia
  • a data (re-)user working for a small startup

And when seeing this very helpful list, I think these are good starting points to think about documentation.
As personas for documentation, I would think about the following dimensions / characteristics:

  • not experienced at all with data(bases) -> extremely experienced
  • not experienced at all with any Wikimedia project but not Wikidata -> extremely experienced with 1 or more Wikimedia projects that are not Wikidata
  • working for an organisation that is a (potential) data provider/donator, e.g. a GLAM

I really like those dimensions and characteristics. I would add that for each one, it's helpful to think about "what is the smallest nugget of information that they need" to "perform X task." and how might that group best learn (Is it audio? Video? Text? A tutorial with detailed diagrams? A 1 on 1 session? A group session?)

Depends… I guess this is still relevant and unresolved as long as the target groups have not been defined somewhere, yet.

Aklapper edited subscribers, added: johl; removed: Jonas.

This task has been assigned to the same task owner for more than two years. Resetting task assignee due to inactivity, to decrease task cookie-licking and to get a slightly more realistic overview of plans. Please feel free to assign this task to yourself again if you still realistically work or plan to work on this task - it would be welcome!

For tips how to manage individual work in Phabricator (noisy notifications, lists of task, etc.), see https://phabricator.wikimedia.org/T228575#6237124 for available options.
(For the records, two emails were sent to assignee addresses before resetting assignees. See T228575 for more info and for potential feedback. Thanks!)

TBurmeister claimed this task.
TBurmeister subscribed.

I am going to boldy mark this task as Resolved because, for multiple sets of documentation and products that exist, personas have been defined: