adr-tools VS pandoc-templates

For architectural decisions I have used this in the past: https://github.com/npryce/adr-tools

👍 This approach is becoming more popular. It's a great way to document decisions and, for many teams, is a core part of their documentation bundle. ADRs don't take very long to put together, but they are incredibly useful to look back on, to help tell stories about how/why things changed, etc. Definitely recommended if you're not using them already, and Nat Pryce's adr-tools tool is an easy way to get started.

Also anyone can write a story in markdown then run it through a Pandoc template: https://github.com/prosegrinder/pandoc-templates

What inspired the question was this script that helps you format your manuscript: https://github.com/prosegrinder/pandoc-templates

Automation if you're computer savvy: https://github.com/prosegrinder/pandoc-templates

Rich text/WYSIWYG editing will only get in your way when you're writing standard fiction without multimedia elements or weird typesetting, and even in those cases it's arguably not the right way to go while you're still working on your manuscript. Tools like Pandoc make it easy enough to compile sets of Markdown files into any kind of .docx-based manuscript format you like (e.g. using scripts like these) or reasonably attractive epubs using some simple CSS.