Helping less technical writers with headless CMS
Earlier in this chapter, I mentioned other common methods for creating documentation outside of the docs as code practice, such as using a CMS or wiki. There is a middle ground that’s quickly worth mentioning: headless CMS. This method is especially useful for those in mixed teams with other team members who might struggle using text editors, markdown, and version control. Instead, you can mix both, using a CMS to create and maintain content workflow and markdown files. The CMS outputs content as JSON APIs that you can consume in frontend applications to render the content.
Many of the tools in the headless CMS world are commercial, such as Contentful (https://www.contentful.com/) and DatoCMS (https://www.datocms.com), but there are a handful of open source options, such as Strapi (https://strapi.io/) and Ghost (https://ghost.org), and even traditional CMS that often have some headless mode these days. I am unsure how popular...
