Stakeholder guide

Documentation and DevRel Owner

Owns onboarding content, developer communication, and documentation quality for API consumers.

Relevant cycles

API Productization Cycle

The API-focused APIOps Cycles journey for productizing, designing, delivering, publishing, and improving APIs.

Automation Cycle

A cycle for identifying, designing, delivering, enabling, and improving automation opportunities.

Relevant stations

  • Consumer Requirements & Onboarding

    Capture consumer onboarding, standards, non-functional requirements, service expectations, constraints, security needs, allowed protocols, data freshness, SLAs, observability, recovery, adoption requirements, and producer responsibilities.

  • Publishing & Enablement

    Publish reusable capability information so consumers can discover, request, onboard, use, and get support.

  • Monitoring & Improvement

    Monitor usage, reliability, data quality, consumer outcomes, operational cost, and reuse opportunities after release.

  • Solution & Interface Design

    Design the interface contract and interaction model after the architecture choice is justified.

Decisions and outputs

Decisions

  • Use the Consumer Experience Requirements Canvas to capture consumer goals, availability, freshness, volume, performance, data quality, security, onboarding, change, observability, and recovery expectations.
  • Use onboarding guidance to describe how consumers will find, request, test, get approved for, and start using the capability.
  • Use the resulting journey and requirements to improve onboarding, documentation, support, and feedback loops for capability consumers.
  • Use consumer experience and onboarding guidance to make expectations explicit for both consumers and producers.
  • The right architecture depends on consumer goals, onboarding expectations, service levels, data quality needs, change tolerance, observability, support, and producer constraints.
  • Publish capability information to the appropriate catalogs, portals, gateways, or environments to support reuse by multiple consumers.

Outputs

  • Documented consumer requirements and onboarding expectations
  • Clear producer responsibilities and support expectations
  • Architecture-relevant constraints ready for decision making
  • Improved adoption through consumer empathy, standards, and producer clarity
  • design-artifact
  • documentation
  • consumer-feedback
  • A discoverable reusable capability

Recommended resources

Facilitate as Documentation and DevRel Owner

Use these prepared prompts alongside the stakeholder decisions, outputs, stations, and resources summarized above.

AI facilitation

Prompt pack

Facilitate a station with Documentation and DevRel Owner

facilitate-station

Stakeholder: Documentation and DevRel Owner
Cycles: Capability Productization Cycle, API Productization Cycle, Integration Productization Cycle, Automation Cycle
Stations: Consumer Requirements & Onboarding, Publishing & Enablement, Monitoring & Improvement, Solution & Interface Design
Resources and canvases: Consumer Experience Requirements Canvas, Domain Canvas, Interaction Canvas, API Value Proposition Canvas, Customer Journey Canvas, REST Canvas, Event Canvas, GraphQL Canvas

Act as an APIOps Cycles facilitator. Use the selected station questions, entry criteria, exit criteria, stakeholders, and related resources to guide the discussion. Produce decisions, evidence gaps, and next steps.