docs: add decisions

docs/README.md

@@ -0,0 +1,5 @@
+# Epic Web Config Docs
+
+This package is pretty simple and small so the docs can been found in the root.
+However, there are decision documents in this folder that you may find
+interesting.

docs/decisions/000-template.md

@@ -0,0 +1,12 @@
+# Title
+
+Date: YYYY-MM-DD
+
+Status: proposed | rejected | accepted | deprecated | superseded by
+[0005](0005-example.md)
+
+## Context
+
+## Decision
+
+## Consequences

docs/decisions/001-reset.md

@@ -0,0 +1,28 @@
+# Reset
+
+Date: 2024-05-25
+
+Status: accepted
+
+## Context
+
+There are some things I want "fixed" in every TypeScript project. For details
+and examples, check
+[the docs for `@total-typescript/ts-reset`](https://www.totaltypescript.com/ts-reset).
+
+In addition to what's available in the `ts-reset` package, I also want to have
+css variable support in the `style` prop of React elements.
+
+I want to handle that automatically in the tsconfig, but the problem is you
+can't disable it, so it's all or nothing and there could be situations where you
+wouldn't want the reset to be applied.
+
+## Decision
+
+We'll create a `reset.d.ts` file and consumers will have to include it in their
+`includes` manually.
+
+## Consequences
+
+It's a bit of extra work, and it's an extra file we have to expose, but it
+strikes the best balance.

docs/decisions/README.md

@@ -0,0 +1,7 @@
+# Decisions
+
+This directory contains all the decisions we've made for this starter template
+and serves as a record for whenever we wonder why certain decisions were made.
+
+Decisions in here are never final. But these documents should serve as a good
+way for someone to come up to speed on why certain decisions were made.