{
  "id": "role:documentation-engineer",
  "_kind": "Role",
  "_file": "domain/roles/roles-additional.yaml",
  "_cluster": "domain",
  "attributes": {
    "displayName": "Documentation Engineer",
    "isAgentic": false,
    "automatability": 0.7,
    "description": "Owns the developer documentation platform and information architecture\nfor engineering-facing content. Goes beyond traditional technical writing\nby building docs-as-code pipelines, automated API reference generation,\ncontent linting, and search optimization. Partners with engineering teams\nto ensure documentation stays accurate, discoverable, and integrated into\ndevelopment workflows through CI-driven freshness checks and review gates.\n",
    "seniority": "mid"
  },
  "outgoingEdges": [
    {
      "from": "role:documentation-engineer",
      "to": "responsibility:documentation",
      "kind": "holds_responsibility"
    },
    {
      "from": "role:documentation-engineer",
      "to": "responsibility:knowledge-sharing",
      "kind": "holds_responsibility"
    },
    {
      "from": "role:documentation-engineer",
      "to": "specialization:technical-documentation",
      "kind": "requires_skill",
      "attributes": {
        "level": "expert"
      }
    },
    {
      "from": "role:documentation-engineer",
      "to": "domain:software-engineering",
      "kind": "requires_skill",
      "attributes": {
        "level": "intermediate"
      }
    }
  ],
  "incomingEdges": [
    {
      "from": "stack-profile:wiki-knowledge-base",
      "to": "role:documentation-engineer",
      "kind": "used_by_role"
    },
    {
      "from": "tool:otter-ai",
      "to": "role:documentation-engineer",
      "kind": "supports_work",
      "attributes": {
        "confidence": "medium",
        "evidence": "Meeting summaries and transcripts support converting discussions into durable documentation."
      }
    },
    {
      "from": "workflow:developer-documentation-review",
      "to": "role:documentation-engineer",
      "kind": "involves_role"
    },
    {
      "from": "workflow:documentation-sprint",
      "to": "role:documentation-engineer",
      "kind": "involves_role"
    },
    {
      "from": "tool-server:mcp-otter-ai-candidate",
      "to": "role:documentation-engineer",
      "kind": "supports_work",
      "attributes": {
        "confidence": "medium",
        "evidence": "Transcript access would support converting meetings into documentation."
      }
    },
    {
      "from": "lib-agent:technical-documentation--api-docs-specialist",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--arch-docs-specialist",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--compliance-docs-specialist",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--content-strategist",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--devops-docs-specialist",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--docs-platform-engineer",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--docs-qa-analyst",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--dx-docs-specialist",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--info-architect",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--l10n-coordinator",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--tech-writer-expert",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-agent:technical-documentation--tutorial-developer",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--adr-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--api-doc-generation",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--api-reference-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--arch-docs-c4",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--content-strategy",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--data-model-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--docs-as-code-pipeline",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--docs-audit",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--docs-localization",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--docs-pr-workflow",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--docs-testing",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--docs-versioning",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--how-to-guides",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--incident-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--interactive-tutorials",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--knowledge-base-setup",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--runbook-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--sdk-doc-generation",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--style-guide-enforcement",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--terminology-management",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-process:technical-documentation--user-guide-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--asyncapi-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--code-sample-validator",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--confluence-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--diagram-generation",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--docs-accessibility",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--docs-analytics",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--docusaurus",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--doxygen-javadoc",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--gitbook-notion",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--jsdoc-tsdoc",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--link-validator",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--markdown-mdx",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--mkdocs-material",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--openapi-swagger",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--pdf-generation",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--readme-platform",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--sphinx-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--storybook-docs",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--tech-writing-lint",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    },
    {
      "from": "lib-skill:technical-documentation--translation-management",
      "to": "role:documentation-engineer",
      "kind": "lib_involves_role",
      "attributes": {
        "weight": 0.7
      }
    }
  ]
}