From 26c3a1dcb51725a99a7a6fc5cd525ee4321e6de2 Mon Sep 17 00:00:00 2001 From: Implementer Date: Thu, 8 Oct 2026 23:23:27 +0200 Subject: [PATCH] Takes conventions v1.46.0 The family resync moves robertblust/conventions in `conventions.json` from v1.45.0 to v1.46.0. The upstream notes are at https://github.com/robertblust/conventions/releases/tag/v1.46.0. Verified: `sh conventions/conventions-sync sync` and `python3 verify.py` passed. Process: Delivery Phase: Implement Track: Code --- .github/workflows/conventions.yml | 2 +- AGENTS.md | 2 +- conventions.json | 2 +- conventions/AGENTS.md | 2 +- conventions/GERMAN.md | 1 + conventions/GLOSSARY.md | 12 +++++++----- conventions/manifest.json | 8 ++++---- 7 files changed, 16 insertions(+), 13 deletions(-) diff --git a/.github/workflows/conventions.yml b/.github/workflows/conventions.yml index 6e4c35d..ef7855b 100644 --- a/.github/workflows/conventions.yml +++ b/.github/workflows/conventions.yml @@ -5,4 +5,4 @@ on: pull_request: jobs: conventions: - uses: robertblust/conventions/.github/workflows/check.yml@v1.45.0 + uses: robertblust/conventions/.github/workflows/check.yml@v1.46.0 diff --git a/AGENTS.md b/AGENTS.md index 6302de1..9eb68f1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,4 @@ - + Shared conventions of the robertblust, guestgraph and companygraph organizations live in `conventions/`, vendored from robertblust/conventions at the release `conventions.json` names. Read them before writing or committing anything here. - `conventions/WRITING.md` — how we write: one voice, three registers, English and German. diff --git a/conventions.json b/conventions.json index dd09525..a72f316 100644 --- a/conventions.json +++ b/conventions.json @@ -1 +1 @@ -{ "repo": "robertblust/conventions", "tag": "v1.45.0" } +{ "repo": "robertblust/conventions", "tag": "v1.46.0" } diff --git a/conventions/AGENTS.md b/conventions/AGENTS.md index 1f8c597..2568465 100644 --- a/conventions/AGENTS.md +++ b/conventions/AGENTS.md @@ -1,4 +1,4 @@ - + Shared conventions of the robertblust, guestgraph and companygraph organizations live in `conventions/`, vendored from robertblust/conventions at the release `conventions.json` names. Read them before writing or committing anything here. - `conventions/WRITING.md` — how we write: one voice, three registers, English and German. diff --git a/conventions/GERMAN.md b/conventions/GERMAN.md index e71a6b3..a919913 100644 --- a/conventions/GERMAN.md +++ b/conventions/GERMAN.md @@ -69,3 +69,4 @@ Each row is a sentence the editor flagged and the owner settled, kept where it g | «Nur würden keine zwei Leute am selben Ort nachschauen» | «Nur schaut jeder an einem anderen Ort nach» | On a slide the owner took the plain indicative. | | «Ein Graph.» | «Ein einziger Graph.» | *One* graph, not *a* graph, where the number is the point. | | «Nicht pro Sitzplatz» | «Nicht pro Nutzer» | A license seat is not a theater seat. | +| «die Sitze, die sie nennen» | «die Sitze, die sie vorsehen» | A process does not *name* its seats in German; it provides for them. | diff --git a/conventions/GLOSSARY.md b/conventions/GLOSSARY.md index 52110ec..ad2b657 100644 --- a/conventions/GLOSSARY.md +++ b/conventions/GLOSSARY.md @@ -27,11 +27,11 @@ The German cells are inline code because the prose check reads no language and a | kind of experience | kind of experience | `Erfahrungsart` | The experience-kind entities — Role, Project, Community, Education, Independent — whose names stay English in both views. The owner's choice over the bare `Art` on a control, which the page's prose may still use for the short form. | | surface | surface | `Surface` | A page the model is published on, written by hand or built by a repository's build, and the type in `model/surfaces/`. A name the ecosystem reads, so not `Oberfläche`, which in German software prose is the user interface. Capitalized as a German noun; feminine, `die Surface`, plural `die Surfaces`. | | lineage | lineage | `Herkunft` | The drawing on a Surfaces page from the model's commit through each maker to its surfaces. Not `Stammbaum`, which reads as family descent, and not `Linie`, which the same page uses for the drawn line itself. companygraph.io's label is `Herkunft der Surfaces`. | -| owner | owner | `Owner` | The one person the company of one is, and the role of that name in the model. Kept English, because the role's name on blust.ch's team page is English in both views and the word and the role are one thing. The owner's choice over `Inhaber`. Masculine, `der Owner`. | +| owner | owner | `Owner` | The one person the company of one is, and the seat of that name in the model. Kept English, because the seat's name on blust.ch's Processes page is English in both views and the word and the seat are one thing. The owner's choice over `Inhaber`. Masculine, `der Owner`. | | owner of a nested entity | owner | `Besitzer` | The entity another is nested under, as a schema names it and as the plugin and the MCP tools' `owner` argument take it; companygraph.io's model page and Obsidian plugin talk. Not the person, who is `Owner`, so two senses keep two words. Masculine, `der Besitzer`. | | pane | pane | `Bereich` | A panel of the Obsidian window, as the plugin's compliance pane or the one Claudian opens; companygraph.io's CLI page and Obsidian plugin talk. The pane's own name stays English, in `«»`. Masculine, `der Bereich`. | -| requestor | Requestor | `Requestor` | The seat that raises a feature request, and the role of that name in companygraph/mental-model. Kept English, as the model's role names are on a team page; masculine, `der Requestor`, like `der Owner`. | -| contributor | Contributor | `Contributor` | The seat that proposes a contribution, and the role of that name in companygraph/mental-model. Kept English for the same reason; masculine, `der Contributor`. | +| requestor | Requestor | `Requestor` | The seat that raises a feature request, so named in companygraph/mental-model. Kept English, as the model's seat names are on a Processes page; masculine, `der Requestor`, like `der Owner`. | +| contributor | Contributor | `Contributor` | The seat that proposes a contribution, so named in companygraph/mental-model. Kept English for the same reason; masculine, `der Contributor`. | | build | build | `Build` | What a repository runs to write a page or a built surface from the model. Kept English like `Connector`; masculine, `der Build`. | | pin | pin | `Pin` | The visible line in which one repository takes another's release or commit; the participle is `gepinnt`. Masculine, `der Pin`. | | commit | commit | `Commit` | A git commit, and the one a pin names. Masculine, `der Commit`; plural `die Commits`. | @@ -64,7 +64,7 @@ The German cells are inline code because the prose check reads no language and a | standard | standard | `Massstab` | A yardstick. Not `Anspruch`, which is this table's claim. | | takeaway | takeaway | `Fazit` | The label that closes a talk's argument. | | Software Engineer & Architect | Software Engineer & Architect | `Software Engineer & Architect` | The owner's title, English in both views, as Swiss IT titles usually are; in a sentence, `Software Engineer und Architect`. | -| seat (billed) | seat | `Nutzer` | What billing does not count: «Nicht pro Nutzer». Not `Sitzplatz`, a seat in a theater; a seat a person holds on a team page stays `Sitz`. | +| seat (billed) | seat | `Nutzer` | What billing does not count: «Nicht pro Nutzer». Not `Sitzplatz`, a seat in a theater; a seat in a process stays `Sitz`. | | retainer | retainer | `Pauschalhonorar` | A flat fee paid ahead of the work. | | day rate | rate | `Tagessatz` | What is billed per day. Not the bare `Satz`, which is also a sentence. | | CLI | CLI | `CLI` | The command-line tool, `die CLI`, even where the English says command line. | @@ -72,8 +72,10 @@ The German cells are inline code because the prose check reads no language and a | maker | maker | `Erzeuger` | What writes a surface, a person or a build. Not `Urheber`, which carries copyright. | | Direction | Direction | `Ausrichtung` | The group over vision, values and strategy. Not `Richtung`, a heading on a map. | | kind | kind | `Art` | The kind of an entity. `Typ` stays for what a schema declares, so the two words keep two meanings. | +| seat | seat | `Sitz` | Core's type: a place in a process that a profile holds, a human or an agent: «Ein Sitz ist kein Mensch.» Not `Rolle`, the type's former name, which stays for a position held. A process provides for its seats, «die Sitze, die sie vorsehen». | +| process | process | `Prozess` | Core's type, the work and its phases; the page `/processes/` is «Prozesse». Not `Ablauf`: the sites write `Prozess` throughout, on the page and in its rules. | | person (in a seat) | person | `Mensch` | The human who holds a seat, set against an agent: «ein Mensch wacht über jedes Gate». An ordinary person stays `Person`. | -| board | board | `Übersicht` | A team page's grid of seats. Not `Tafel`, a blackboard. | +| board | board | `Übersicht` | A Processes page's grid of seats, one per process. Not `Tafel`, a blackboard. | | projection | projection | `Projektion` | The model as a derived view of how a company runs. | | adoption | adoption | `Verbreitung` | A thing others take up: «wenn es sich durchsetzt … seine Verbreitung». | | process (data) | process | `bearbeiten` | The DSG's verb, for content as well as personal data, on a page that names the DSG. | diff --git a/conventions/manifest.json b/conventions/manifest.json index 27cc5d5..e36c1e3 100644 --- a/conventions/manifest.json +++ b/conventions/manifest.json @@ -1,6 +1,6 @@ { "repo": "robertblust/conventions", - "tag": "v1.45.0", + "tag": "v1.46.0", "files": { "conventions/WRITING.md": "sha256:51d9a902ec3038392160df07f86aba98d34db1d4dbfaa5f4a647590eaccfb390", "conventions/WORKING.md": "sha256:3a7a6b4ab1bd23f2407fc6ada2dd0512710a49d233fa7c3342951f6fc526ab23", @@ -8,11 +8,11 @@ "conventions/PINS.md": "sha256:68df67ae820a8673d3130582aa829d4283176d3c8ec0a69adda3132a1a755b93", "conventions/WRITER.md": "sha256:bc3b92683130b75993f824f0e34073d4344846c91be2009fd90c39099fd4fd48", "conventions/TRANSLATOR.md": "sha256:3a3d2d0916d7230cbc760bced1be249b11cc516956fb41ad010b3216f23024ba", - "conventions/GLOSSARY.md": "sha256:1d0fbdb8415f8a65ccee75b4a26617d7aa1a4b146988cc2a2a8155fe67c02623", - "conventions/GERMAN.md": "sha256:2f4651dd74e2970f0751621bf9264441b43ee619b8a6e1373d5f3c7809581f77", + "conventions/GLOSSARY.md": "sha256:429733de608d68142cc261dc48aa4fdf0dde3dd002902f0af413a63e6467f9b9", + "conventions/GERMAN.md": "sha256:e8b311ed4b48cc2ded964bbaa0cfcf70178cdbd8072cd467b586c2bfa0cb949b", "conventions/EDITOR.md": "sha256:e65d0b2893ac841faefede9b873f7e33c1fd7b02bedf97d37d5362c0e83c08ea", "conventions/BACKREADER.md": "sha256:36b12d4bee8e4fe190469e2f550d50d8a7f6dcab6bec573da17eb1c165c417cd", - "conventions/AGENTS.md": "sha256:cf77443379ef6a03519abd64b925708841721640046e591843eeccbbfb557cd0", + "conventions/AGENTS.md": "sha256:861c1ec80624afb6e87a993922a18ea101cc718ace94e4237c7da89bf6367f2b", "conventions/conventions-sync": "sha256:a190ff79c2d8d3f6f6d9a597e9f261654f2419d30e2ac43abf6c64ebe2c47ed9", "conventions/conventions-check": "sha256:fb55ca4b4cfc5caa0d346ad6c705d4402125155f95db6c974099a8112e275c69", "conventions/conventions-format": "sha256:2911a0d30dda1bc0f621522a9538b3e39704eee03458e65ba320eccbf39b5c7f",