Page MenuHomePhabricator

Who are the target users of our documentation
Open, NormalPublic

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

Lydia_Pintscher moved this task from incoming to monitoring on the Wikidata board.Mar 23 2017, 2:41 PM
Spinster added a subscriber: Spinster.

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?)