7e75411efdf3f7fe3c561ea09b57ff34a82ee889
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 |