Why Document Authoring Wins

by Josh Oransky

The argument over which authoring surface to use on Edge Delivery Services has become slightly religious. Universal Editor is the new sanctioned answer. SharePoint is the "we already use Microsoft" answer. Document Authoring (DA) is the "you're a developer who likes simple things" answer. They all work. After enough rebuilds, one of them tends to come out ahead, and it's usually DA.

The argument against

DA looks alarmingly simple. There is no preview pane. There is no WYSIWYG editor. There is no schema definition file. Authors edit pages in a tab that looks like a Notion document and click Preview to render. Stakeholders see this and worry the platform isn't "enterprise enough."

Then a content team uses it for two weeks and stops complaining.

Why authors actually like it

The same simplicity that worried stakeholders is what authors find liberating. The page is a document. Sections are paragraphs. Blocks are tables. Everything is keyboard-driven, copy-pasteable, and version-controlled by Git through the round-trip API. Authors who have spent a decade fighting AEM's component dialogs and inherited overlays do not miss them.

You also get a few specific wins:

• Multi-author concurrency works. Multiple people can edit the same page simultaneously without locking. The collaboration model is the document, not the component.
• Bulk operations are trivial. Find and replace across hundreds of pages is a single API call, not a sprint of dialogs.
• Roundtripping to code is clean. Pulling content into a repo, editing programmatically, and pushing it back is the supported workflow, not a hack.
• Onboarding takes hours. If a new hire can write a doc, they can author a page. Universal Editor takes a week of training to use properly.

When you should not use DA

There are workflows DA is not the right tool for. Highly structured content (product catalogs, taxonomy-driven listings, anything where the field set is non-negotiable) wants Universal Editor's typed forms. Headless consumption by mobile apps wants AEM Sites as the backend with EDS as the public front end.

But for the standard marketing site, the blog, the resource library, and the campaign landing pages, DA is faster to author, faster to learn, faster to build against, and faster to migrate to than any of the alternatives. The shape of the document IS the shape of the page. That correspondence is the whole point.

"Enterprise enough" usually turns out to mean "complex enough that the procurement team feels okay paying for it." Authors don't care about that. They care whether they can publish before the marketing window closes. DA lets them.