{
  "id": "workflow:migration-guide-authoring",
  "_kind": "Workflow",
  "_file": "workflows/workflows/workflows-docs-deep.yaml",
  "_cluster": "workflows",
  "attributes": {
    "displayName": "Migration Guide Authoring",
    "workflowKind": "development",
    "triggerType": "event-driven",
    "typicalCadence": "per-major-release",
    "complexity": "cross-team",
    "description": "Authors comprehensive migration guides for breaking changes — inventorying\nall breaking changes and deprecations, writing step-by-step upgrade\ninstructions with code examples, providing codemods or automated fix\nscripts, testing guides against real consumer codebases, and publishing\nwith version-specific navigation. Excludes the breaking change\nimplementation itself.\n"
  },
  "outgoingEdges": [
    {
      "from": "workflow:migration-guide-authoring",
      "to": "role:technical-writer",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "role:devrel",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "role:staff-engineer",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "skill-area:tutorial-design",
      "kind": "requires_skill_area",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "skill-area:breaking-change-management",
      "kind": "requires_skill_area",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "domain:software-engineering",
      "kind": "applies_to_domain",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "domain:platform-engineering",
      "kind": "applies_to_domain",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "responsibility:write-user-docs",
      "kind": "triggers_responsibility",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "responsibility:changelog-maintenance",
      "kind": "triggers_responsibility",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "org-unit:devrel-team",
      "kind": "performed_by_org_unit",
      "attributes": {}
    },
    {
      "from": "workflow:migration-guide-authoring",
      "to": "org-unit:engineering",
      "kind": "performed_by_org_unit",
      "attributes": {}
    }
  ],
  "incomingEdges": []
}