workflow:documentation-freshness-audit

{
  "id": "workflow:documentation-freshness-audit",
  "_kind": "Workflow",
  "_file": "workflows/workflows/workflows-deeper-domains.yaml",
  "_cluster": "workflows",
  "attributes": {
    "displayName": "Documentation Freshness Audit",
    "workflowKind": "governance",
    "triggerType": "scheduled",
    "typicalCadence": "quarterly",
    "complexity": "cross-team",
    "description": "Audits documentation freshness and accuracy across all\nknowledge-management surfaces -- scanning document repositories for pages\nnot updated within staleness thresholds, cross-referencing API\ndocumentation against current endpoint schemas for drift detection,\nvalidating runbook accuracy by comparing documented procedures against\nactual system configurations, reviewing onboarding documentation\ncompleteness against current toolchain and process, assessing\ncode-comment accuracy in frequently changed modules, measuring\ndocumentation coverage ratios for public APIs and internal services, and\ntriaging stale content for update, archive, or deletion. Produces\ndocumentation freshness scorecard and remediation backlog. Excludes\ndocumentation authoring.\n"
  },
  "outgoingEdges": [
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "role:technical-writer",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "role:doc-generator",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "role:engineering-manager",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "skill-area:docs-as-code",
      "kind": "requires_skill_area",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "skill-area:api-doc-generation",
      "kind": "requires_skill_area",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "domain:knowledge-management",
      "kind": "applies_to_domain",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "domain:software-engineering",
      "kind": "applies_to_domain",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "responsibility:write-user-docs",
      "kind": "triggers_responsibility",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "responsibility:changelog-maintenance",
      "kind": "triggers_responsibility",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "org-unit:devrel-team",
      "kind": "performed_by_org_unit",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "org-unit:engineering",
      "kind": "performed_by_org_unit",
      "attributes": {}
    },
    {
      "from": "workflow:documentation-freshness-audit",
      "to": "org-unit:engineering-productivity",
      "kind": "performed_by_org_unit",
      "attributes": {}
    }
  ],
  "incomingEdges": []
}