Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/conventions.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<!-- conventions · v1.45.0 -->
<!-- conventions · v1.46.0 -->
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.
Expand Down
2 changes: 1 addition & 1 deletion conventions.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{ "repo": "robertblust/conventions", "tag": "v1.45.0" }
{ "repo": "robertblust/conventions", "tag": "v1.46.0" }
2 changes: 1 addition & 1 deletion conventions/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<!-- conventions · v1.45.0 -->
<!-- conventions · v1.46.0 -->
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.
Expand Down
1 change: 1 addition & 0 deletions conventions/GERMAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
12 changes: 7 additions & 5 deletions conventions/GLOSSARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`. |
Expand Down Expand Up @@ -64,16 +64,18 @@ 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. |
| chat panel | panel | `Chatfenster` | The chat's panel on a page. |
| 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. |
Expand Down
8 changes: 4 additions & 4 deletions conventions/manifest.json
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
{
"repo": "robertblust/conventions",
"tag": "v1.45.0",
"tag": "v1.46.0",
"files": {
"conventions/WRITING.md": "sha256:51d9a902ec3038392160df07f86aba98d34db1d4dbfaa5f4a647590eaccfb390",
"conventions/WORKING.md": "sha256:3a7a6b4ab1bd23f2407fc6ada2dd0512710a49d233fa7c3342951f6fc526ab23",
"conventions/REPOSITORIES.md": "sha256:461654ef06ee307d2e10daba201e97dbcad093cf6b3b7c35b6bad3627f9f4fec",
"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",
Expand Down
Loading