﻿---
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://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2824/migration
---

# 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://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2824/migration/syntax): from AsciiDoc to Markdown
- [New information architecture (IA)](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2824/migration/ia): aligning docs around user goals, not internal org structure
- [New versioning](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2824/migration/versioning): consolidation from many to one
- [New reference guidelines](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2824/migration/engineering): Engineering ownership of reference documentation & New API guidelines

View the [migration guide](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2824/migration/guide) to learn more about migration tooling, what content sets are migrating, how to migrate content, and more.