{"componentChunkName":"component---src-pages-updates-migration-guide-overview-mdx","path":"/updates/migration-guide/overview/","result":{"pageContext":{"frontmatter":{"title":"Migration guide","description":"This guide includes everything you need to migrate your offering from an older version of Carbon to v10.","tabs":["Overview","Design","Develop"]},"relativePagePath":"/updates/migration-guide/overview.mdx","titleType":"prepend","MdxNode":{"id":"e41f5bae-739e-5c4d-9e3a-1898a2076840","children":[],"parent":"890aab56-f2f4-5ba4-b32c-dd3c8bfb23d9","internal":{"content":"---\ntitle: Migration guide\ndescription: This guide includes everything you need to migrate your offering from an older version of Carbon to v10.\ntabs: [\"Overview\", \"Design\", \"Develop\"]\n---\n\n<PageDescription>\n\nThis guide includes everything you need to migrate your offering from Carbon v9 to v10.\n\n</PageDescription>\n\n<AnchorLinks>\n\n<AnchorLink>Transitioning to v10</AnchorLink>\n<AnchorLink>Migration strategy</AnchorLink>\n<AnchorLink>Feedback</AnchorLink>\n\n</AnchorLinks>\n\n## Transitioning to v10\n\nThe transition path to v10 was designed to be as seamless as possible but there are breaking changes. This guide is for teams migrating from v9 to v10. If your team uses an older version of Carbon, some of this information may not apply to you.\n\n<Row>\n<Column colLg={4} colMd={4} noGutterSm>\n<ResourceCard\n    subTitle=\"Looking for v9?\"\n    href=\"https://v9.carbondesignsystem.com/\"\n    >\n\n<MdxIcon name=\"codesandbox\" />\n\n  </ResourceCard>\n</Column>\n</Row>\n\n## Migration strategy\n\n**Have a plan.** Meet with stakeholders from design, OM, and engineering to kick off the migration process. Establish dedicated channels of communication for migration, and involve the broader team as needed.\n\n**Migrate in a dedicated branch.** This update includes substantial changes to layout and spacing. We don't recommend a piece-by-piece migration of your product in production. Teams should perform the migration first in a separate branch (or branches). This allows the creation of new design specs for any possible rough spots in alignment or sizing that may appear in the UI after upgrading.\n\n**Tackle components, colors, type, spacing, and iconography first.** Aligning your product to the new grid will be design-intensive, and can be tackled after the breaking changes with other elements have been addressed.\n\n## Feedback\n\nTo improve this guide, make a suggestion, or just ask a question, please [open an issue](https://github.com/carbon-design-system/carbon/issues/new?template=feedback.md&labels=feedback&title=User+feedback+for+Migration+Overview+page) on GitHub.\n","type":"Mdx","contentDigest":"f8712fd78e17b26df51c0644cdb82f80","counter":1660,"owner":"gatsby-plugin-mdx"},"frontmatter":{"title":"Migration guide","description":"This guide includes everything you need to migrate your offering from an older version of Carbon to v10.","tabs":["Overview","Design","Develop"]},"exports":{},"rawBody":"---\ntitle: Migration guide\ndescription: This guide includes everything you need to migrate your offering from an older version of Carbon to v10.\ntabs: [\"Overview\", \"Design\", \"Develop\"]\n---\n\n<PageDescription>\n\nThis guide includes everything you need to migrate your offering from Carbon v9 to v10.\n\n</PageDescription>\n\n<AnchorLinks>\n\n<AnchorLink>Transitioning to v10</AnchorLink>\n<AnchorLink>Migration strategy</AnchorLink>\n<AnchorLink>Feedback</AnchorLink>\n\n</AnchorLinks>\n\n## Transitioning to v10\n\nThe transition path to v10 was designed to be as seamless as possible but there are breaking changes. This guide is for teams migrating from v9 to v10. If your team uses an older version of Carbon, some of this information may not apply to you.\n\n<Row>\n<Column colLg={4} colMd={4} noGutterSm>\n<ResourceCard\n    subTitle=\"Looking for v9?\"\n    href=\"https://v9.carbondesignsystem.com/\"\n    >\n\n<MdxIcon name=\"codesandbox\" />\n\n  </ResourceCard>\n</Column>\n</Row>\n\n## Migration strategy\n\n**Have a plan.** Meet with stakeholders from design, OM, and engineering to kick off the migration process. Establish dedicated channels of communication for migration, and involve the broader team as needed.\n\n**Migrate in a dedicated branch.** This update includes substantial changes to layout and spacing. We don't recommend a piece-by-piece migration of your product in production. Teams should perform the migration first in a separate branch (or branches). This allows the creation of new design specs for any possible rough spots in alignment or sizing that may appear in the UI after upgrading.\n\n**Tackle components, colors, type, spacing, and iconography first.** Aligning your product to the new grid will be design-intensive, and can be tackled after the breaking changes with other elements have been addressed.\n\n## Feedback\n\nTo improve this guide, make a suggestion, or just ask a question, please [open an issue](https://github.com/carbon-design-system/carbon/issues/new?template=feedback.md&labels=feedback&title=User+feedback+for+Migration+Overview+page) on GitHub.\n","fileAbsolutePath":"/zeit/3b23ef32/src/pages/updates/migration-guide/overview.mdx"}}}}