cloudposse / cloudposse/docs

Document Mantras

Open
#356 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
MDX
Stars
99
Forks
34
PR merge metrics
No merged PRs in 30d

Description

## 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.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.