authoring-tools-research

Overview: Tools for authoring and publishing repo-based content

The search for fast, efficient ways to create and manage content.

Criteria:

• Understands Markdown
• Local authoring story (including local tool install)
• Ease of publish, i.e., without programming/configuring a full CICD pipeline
• Not a subscription-based, hosted service (e.g., not GitBook)

Players thus far

• Github Pages
• MDBook
• Google Codelabs

See also (further research TBD):

• Pandoc - A universal document converter - Example usage here
• mkdocs.org - Used by Stark & Wayne in their Concourse tutorial- “a fast, simple and downright gorgeous static site generator that’s geared towards building project documentation.”