[spondylosaurus]

Technical writer here: most TWs I know either lean hard into docs-as-code toolchains (raises hand) or fall the other way into the territory of safe but limited hosted tools, like Zendesk or ReadMe. A headless CMS seems like it falls into the awkward middle—too fiddly for people who want something that "just works," too restricting for people who do want full control to fiddle with their docs. I have to confess that I've been forced to use a headless CMS tool (Contentful) for docs in the past and I loathed it.

Marketers, on the other hand, love headless CMS tools. They're the ones who forced me to use one, since our main website and blog were also built on Contentful at the time. I think headless CMS tools offer the perfect level of configuration and modular authoring for them without the daunting hurdle of having to learn to code(ish).