Skip to content

Commit 2269ec8

Browse files
raifdmuellerclaude
andcommitted
fix: add German translation, changelog, metadata for Effective Go (#404)
Post-merge cleanup for PR #404: - German translation (effective-go.de.adoc) - Added related anchors (clean-code, conventional-commits) - Changelog entry - Regenerated metadata Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 5526475 commit 2269ec8

9 files changed

Lines changed: 238 additions & 132 deletions

File tree

docs/all-anchors.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,8 @@ include::anchors/conventional-commits.adoc[leveloffset=+2]
127127

128128
include::anchors/definition-of-done.adoc[leveloffset=+2]
129129

130+
include::anchors/effective-go.adoc[leveloffset=+2]
131+
130132
include::anchors/github-flow.adoc[leveloffset=+2]
131133

132134
include::anchors/mental-model-according-to-naur.adoc[leveloffset=+2]

docs/anchors/effective-go.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
= Effective Go
22
:categories: development-workflow
33
:roles: software-developer, software-architect
4+
:related: clean-code, conventional-commits
45
:proponents: The Go Authors
56
:tags: go, golang, best-practices, idiomatic, style-guide
67
:tier: 3

docs/anchors/effective-go.de.adoc

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
= Effective Go
2+
:categories: development-workflow
3+
:roles: software-developer, software-architect
4+
:related: clean-code, conventional-commits
5+
:proponents: The Go Authors
6+
:tags: go, golang, best-practices, idiomatic, style-guide
7+
:tier: 3
8+
9+
[%collapsible]
10+
====
11+
12+
[discrete]
13+
== *Kernkonzepte*:
14+
15+
Formatierung (gofmt):: Code wird automatisch formatiert; Stildiskussionen werden durch Tooling eliminiert
16+
17+
Paketnamen:: Kurz, kleingeschrieben, keine Unterstriche; der Paketname ist Teil des qualifizierten Bezeichners
18+
19+
Benannte Rückgabewerte:: Rückgabewerte können benannt und als Dokumentation verwendet werden
20+
21+
Defer:: Verzögerte Funktionsaufrufe werden in LIFO-Reihenfolge ausgeführt, wenn die umgebende Funktion zurückkehrt; verwendet für Aufräumarbeiten (close, unlock)
22+
23+
Goroutinen:: Leichtgewichtige, nebenläufig ausgeführte Funktionen; „Kommuniziere nicht durch gemeinsamen Speicher; teile Speicher durch Kommunikation"
24+
25+
Channels:: Typisierte Kanäle für Goroutinen-Kommunikation; erstklassiges Synchronisierungsprimitiv
26+
27+
Interfaces:: Implizite Erfüllung — ein Typ implementiert ein Interface, indem er einfach dessen Methoden implementiert; ermöglicht Duck Typing
28+
29+
Fehlerbehandlung:: Fehler sind Werte; idiomatisches Muster ist `if err != nil` an jeder Aufrufstelle; keine Exceptions
30+
31+
Blank Identifier (_):: Ungewollte Werte aus Multi-Value-Returns verwerfen, ohne Compilerfehler
32+
33+
Embedding:: Komposition statt Vererbung; Typen können andere Typen einbetten, um deren Methoden zu erhalten
34+
35+
Schlüsselvertreter:: The Go Authors (https://go.dev/doc/effective_go)
36+
37+
[discrete]
38+
== *Wann zu verwenden*:
39+
40+
* Einarbeitung neuer Go-Entwickler in idiomatischen Go-Stil
41+
* Code-Review-Diskussionen über Go-Konventionen
42+
* Etablierung teamweiter Go-Codierungsstandards
43+
* Erklärung von Go-Idiomen, die sich von anderen Sprachen unterscheiden (z.B. Fehlerbehandlung, Interfaces)
44+
* LLM-Prompting für idiomatischen, produktionsreifen Go-Code
45+
46+
====

docs/changelog.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,12 @@
22

33
A chronological record of all semantic anchors added to the catalog. Community contributors are credited with thanks.
44

5+
== 2026-04-01
6+
7+
*New anchors:*
8+
9+
* *Effective Go* — The Go Authors' canonical guide to idiomatic Go
10+
511
== 2026-03-29
612

713
*New category:* `Creative Writing & Storytelling`

website/public/data/anchors.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -451,7 +451,10 @@
451451
"software-developer",
452452
"software-architect"
453453
],
454-
"related": [],
454+
"related": [
455+
"clean-code",
456+
"conventional-commits"
457+
],
455458
"proponents": [
456459
"The Go Authors"
457460
],

website/public/data/metadata.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
{
2-
"generatedAt": "2026-03-29T19:29:34.681Z",
2+
"generatedAt": "2026-04-01T08:18:02.208Z",
33
"version": "1.0.0",
44
"counts": {
5-
"anchors": 121,
5+
"anchors": 122,
66
"categories": 14,
77
"roles": 12
88
},
99
"statistics": {
10-
"averageRolesPerAnchor": "3.15",
10+
"averageRolesPerAnchor": "3.14",
1111
"averageCategoriesPerAnchor": "1.01",
12-
"anchorsWithTags": 81,
13-
"anchorsWithRelated": 52
12+
"anchorsWithTags": 82,
13+
"anchorsWithRelated": 53
1414
}
1515
}

website/public/data/roles.json

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -217,6 +217,7 @@
217217
"cynefin-framework",
218218
"devils-advocate",
219219
"domain-driven-design",
220+
"effective-go",
220221
"event-driven-architecture",
221222
"fagan-inspection",
222223
"fowler-patterns",
@@ -291,6 +292,7 @@
291292
"definition-of-done",
292293
"docs-as-code",
293294
"domain-driven-design",
295+
"effective-go",
294296
"event-driven-architecture",
295297
"fagan-inspection",
296298
"feynman-technique",

website/public/llms.txt

Lines changed: 40 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Semantic Anchors — Complete Reference
22

3-
> 122 well-defined terms, methodologies, and frameworks
3+
> 123 well-defined terms, methodologies, and frameworks
44
> that serve as precision reference points when communicating with LLMs.
55
> Source: https://github.com/LLM-Coding/Semantic-Anchors
66
> Website: https://llm-coding.github.io/Semantic-Anchors/
@@ -1935,6 +1935,42 @@ A class should have only one reason to change. Each module or class should be re
19351935
* User Story Mapping - Planning technique that identifies the scope Definition of Done must cover
19361936
* MoSCoW - Prioritization method used to decide which DoD items are must-haves
19371937

1938+
### Effective Go
1939+
1940+
[discrete]
1941+
## **Core Concepts**:
1942+
1943+
***Formatting (gofmt)***: Code is auto-formatted; style debates are eliminated by tooling
1944+
1945+
***Package names***: Short, lowercase, no underscores; package name is part of the qualified identifier
1946+
1947+
***Named return values***: Return values can be named and used as documentation
1948+
1949+
***Defer***: Deferred function calls run in LIFO order when the surrounding function returns; used for cleanup (close, unlock)
1950+
1951+
***Goroutines***: Lightweight concurrently executing functions; "Don't communicate by sharing memory; share memory by communicating"
1952+
1953+
***Channels***: Typed conduits for goroutine communication; first-class synchronization primitive
1954+
1955+
***Interfaces***: Implicit satisfaction — a type implements an interface simply by implementing its methods; enables duck typing
1956+
1957+
***Error handling***: Errors are values; idiomatic pattern is `if err != nil` at each call site; no exceptions
1958+
1959+
***Blank identifier (_)***: Discard unwanted values from multi-value returns without compiler error
1960+
1961+
***Embedding***: Composition over inheritance; types can embed other types to gain their methods
1962+
1963+
***Key Proponent***: The Go Authors (https://go.dev/doc/effective_go)
1964+
1965+
[discrete]
1966+
## **When to Use**:
1967+
1968+
* Onboarding new Go developers to idiomatic Go style
1969+
* Code review discussions about Go conventions
1970+
* Establishing team-wide Go coding standards
1971+
* Explaining Go idioms that differ from other languages (e.g. error handling, interfaces)
1972+
* Prompting an LLM to produce idiomatic, production-quality Go code
1973+
19381974
### GitHub Flow
19391975

19401976
[discrete]
@@ -4947,7 +4983,8 @@ Select and download: https://llm-coding.github.io/Semantic-Anchors/#/contracts
49474983
## Specification
49484984

49494985
When we talk about a "specification" or "spec", we mean:
4950-
- Use Cases with Activity Diagrams (all paths, not just the happy path)
4986+
- Use Cases with Trigger, Main Flow, Alternative Flows, Postconditions, and Business Rules (BR-IDs)
4987+
- Activity Diagrams for all flows (not just the happy path)
49514988
- Acceptance criteria in Gherkin format (Given/When/Then)
49524989

49534990
*Referenced anchors: gherkin, bdd-given-when-then*
@@ -4998,6 +5035,7 @@ For each issue:
49985035
- Select next issue from backlog (respect dependencies)
49995036
- Analyze and document analysis as a comment on the issue
50005037
- Implement using TDD (London or Chicago School as appropriate)
5038+
- Each test references its Use Case ID for traceability
50015039
- Commit with Conventional Commits, reference issue number
50025040
- Check if spec or architecture docs need updating
50035041
- When EPIC is complete, create a Pull Request

0 commit comments

Comments
 (0)