Document Mantras

[osterman]

what

• Document some of our design philosophies

examples

Golang philosophy:

A little duplication is better than the wrong abstraction Less is exponentially more (https://commandcenter.blogspot.com/2012/06/less-is-exponentially-more.html)

Cloud Posse

• Use industry standard tools over custom ones. e.g. terraform and chamber.
• Favor documentation over automation. Instead of wrapping terraform and obfuscating layers of complexity, provide documentation on terraform "best practices" and actionable examples.
• Automate Repetitive Processes using Makefiles. Only introduce automation when a repetitive workflow emerges. Write simple shell scripts that provide minimal orchestration to avoid obfuscation of the underlying workflows.