Skip to main content

Introduction

DocStatic is a modern documentation platform that bridges the gap between writers and developers to help you create online documentation your users will love.

It simultaneously provides the best features of component content management systems and docs-as-code solutions for online documentation. With DocStatic, anyone on your team can create and edit your documents without sacrificing your developer workflow.

Features​

DocStatic is a refinement of Tinasaurus, an open-source React-based project that combines a static site generator (Docusaurus) with a headless content management system (TinaCMS). It includes:

  • An easy-to-use editing interface for Markdown, MDX, JSON, and YAML content.
  • Integration with existing Git and CI/CD workflows.
  • Embedded MDX components.
  • Media manager with support for third-party media providers.
  • Editing in the cloud (no local setup required).

Easy content management​

DocStatic's default collections include some of the more advanced authoring features you'd expect to find in a CCMS.

The rich text editor makes it easy to add:

  • Conditional text, snippets, and variable sets for content reuse
  • Taxonomies
  • Glossary terms
  • Code blocks, comments, collapsible details, figure, footnotes, and tabs. These are available as templates that you can insert into a content file.

The CMS uses a GraphQL schema to describe the shape of your content as a set of collections.

Git-backed​

Source control, automation and, optionally, publishing are managed through GitHub. When editing files with the rich-text editor, TinaCMS either commits on save or saves directly to the file if working locally. Git remains the source of truth for the whole team.

The repository structure is very similar to the Docusaurus defaults, but with some changes required for integration with TinaCMS.

Preconfigured plugins​

DocStatic is preconfigured with plugins supporting features such as KaTeX equations, Lunr search, Mermaid diagrams and OpenAPI docs. There is built-in support for internationalization (i18n). Multilingual spelling, grammar and, optionally, style checking are provided by LanguageTool through browser and IDE plugins.

React-based​

Content is stored in MDX format—an extension to Markdown that supports custom React components for features such as admonitions. These components are available universally and do not need to be declared in individual files. When working locally, the dev server instantly recompiles pages when you save your changes.

Fully documented​

Developers will find all the information they need to configure and start using DocStatic in the Docusaurus and TinaCMS documentation. That information is not duplicated here, to avoid the possibility of it becoming out of date. Instead, the DocStatic documentation focuses on using the CMS.