---
title: Migration to docs-builder
description: Migrating to Elastic Docs V3 is more than just moving to a new documentation build system. This migration includes: New syntax: from AsciiDoc to Markdown,...
url: https://www.elastic.co/elastic/docs-builder/docs/3243/reference/docs-builder/migration
products:
  - Elastic Docs Builder
---

# Migration to docs-builder
<important>
  All repositories have been migrated to `docs-builder` however older branches may still be using `asciidoc`.
</important>

Migrating to Elastic Docs V3 is more than just moving to a new documentation build system. This migration includes:
- [New syntax](https://www.elastic.co/elastic/docs-builder/docs/3243/reference/docs-builder/migration/syntax): from AsciiDoc to Markdown
- [New information architecture (IA)](https://www.elastic.co/elastic/docs-builder/docs/3243/reference/docs-builder/migration/ia): aligning docs around user goals, not internal org structure
- [New versioning](https://www.elastic.co/elastic/docs-builder/docs/3243/reference/docs-builder/migration/versioning): consolidation from many to one
- [New reference guidelines](https://www.elastic.co/elastic/docs-builder/docs/3243/reference/docs-builder/migration/engineering): Engineering ownership of reference documentation & New API guidelines

View the [migration guide](https://www.elastic.co/elastic/docs-builder/docs/3243/reference/docs-builder/migration/guide) to learn more about migration tooling, what content sets are migrating, how to migrate content, and more.