Skip to content

Commit 37e40f0

Browse files
committed
change glossary rule
1 parent 17fc461 commit 37e40f0

2 files changed

Lines changed: 2 additions & 2 deletions

File tree

i18n/en/docusaurus-plugin-content-docs/current/guides/examples/entity-layer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ Create a document (not code!) describing your application's business domain:
134134
- **Relationships:** belongs to Category, included in Orders
135135
```
136136

137-
The glossary is maintained by the business side. Developers update the entities layer to reflect what the glossary describes — not the other way around.
137+
The glossary is a shared artifact — ideally maintained collaboratively by developers, product managers, and domain experts. The key principle is that code should reflect the domain language, not define it.
138138

139139
**Purpose of the glossary:**
140140
- Document domain understanding

i18n/ru/docusaurus-plugin-content-docs/current/guides/examples/entity-layer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ interface User {
134134
- **Связи:** принадлежит Category, входит в Orders
135135
```
136136

137-
Глоссарий ведёт бизнес. Разработчики обновляют слой entities в соответствии с тем, что глоссарий описывает — а не наоборот.
137+
Глоссарий — общий артефакт, который в идеале поддерживается совместно: разработчиками, менеджерами продукта и экспертами в предметной области. Ключевой принцип: код должен отражать язык домена, а не определять его.
138138

139139
**Цель глоссария:**
140140
- Документировать понимание домена

0 commit comments

Comments
 (0)