Home.md
... ...
@@ -29,12 +29,32 @@ Slack](https://clojurians.slack.com/archives/C06U8EJEXAM?ref=gaiwan.co). We
29 29
welcome constructive feedback, suggested edits, new topics that you'd like to
30 30
see us cover, or just any random pattern-related chat.
31 31
32
-
33
-
32
+## A Pattern Language
33
+
34
+The patterns in this wiki together form [A Pattern Language](PatternLanguage),
35
+we recommend starting here to understand what we mean exactly when we say
36
+"Pattern" or "Pattern Language".
37
+
38
+Patterns exist to resolve tensions, so any exploration of a pattern must start
39
+with an exploration of the tensions which are present. A good problem statement
40
+is always the hardest part, after that we can consider solutions. When it comes
41
+to documenting patterns, we try to separate three different aspects.
42
+
43
+1. **The Pattern itself** This is an abstract description of the tensions that the
44
+ pattern seeks to resolve, and how it resolves them. We try to document the
45
+ various concerns that we identify that might have an influence on this
46
+ pattern.
47
+2. **Ecosystem analysis** A description of the various implementations *out
48
+ there* that we are aware of, in particular in the Clojure space where we are
49
+ most active, for patterns where this is relevant. We try to be reasonably
50
+ objective, and use the foregoing description to help us consider how
51
+ different approaches differ and can be compared and evaluated.
52
+3. **Gaiwan Stack** The solution we have settled on for our projects. We do not
53
+ purport that this is always the _best_ solution, but it's the solution we
54
+ like, or that we are used to, and that has worked reasonably well for us.
34 55
35 56
## Patterns
36 57
37
-- [[PatternLanguage]] - **Start Here** collection of organizational and architectural patterns and principles
38 58
- [[UriAsData]] - Recommends managing URIs as structured data for reliability.
39 59
- [[DevEnvironmentLauncher]] - Simplifies and standardizes development setup for consistency and efficiency.
40 60
... ...
@@ -42,6 +62,8 @@ see us cover, or just any random pattern-related chat.
42 62
43 63
- [[DevEnvironmentLauncherEcosystem]]
44 64
65
+## Gaiwan Stack
66
+
45 67
<<Navigation("Gaiwan Stack", "GaiwanStack", false)>>
46 68
47 69