Skip to content

Clarify user personas in documentation #58

@rudokemper

Description

@rudokemper

As we expand Guardian Connector documentation, it’s becoming clear that different pages serve very different audiences. For example:

  • A community organization’s technical data manager that wants to set up a Windmill script
  • A system administrator / developer deploying GC
  • A casual reader curious about GC principles

Right now, these audiences are not always explicitly signaled. This can create friction if someone stumbles onto a page not meant for them.

Proposal

  1. Define user personas in one central page (e.g. "Who this documentation is for") and refer back to it throughout the docs.
  2. Mark each page with its intended audience at the top (e.g. “This page is written for: System administrators”).
  3. Audit existing docs and tag them with personas.

Related discussions

Metadata

Metadata

Assignees

Labels

referenceImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions