docs(glossary): add Agent, Operator, Service; split "exposed" #19

Merged

pit merged 1 commit from docs/glossary-exposure-and-agent-terms into main

2026-10-06 12:04:58 +00:00

pit commented

2026-10-06 12:04:16 +00:00

Owner

Adds four terms the forgejo-mcp grilling surfaced, and fixes one overloaded word.

Operator and Agent (new ## People section): docs/agents/ and docs/agents/domain.md use both words throughout without ever defining them.
Service (under Structure): a program an Ansible role installs on a Guest and runs under systemd. Forgejo and the Actions runner are already two; the distinction was implicit in the architecture page only.
LAN-reachable / WAN-published (new ## Exposure section): "exposed" was being asked to mean both at once. The pair keeps the Edge's WAN-only definition intact and makes the exposure decision explicit.

Definitions only — no implementation detail, per the glossary's own rule.

Context: this vocabulary is what the forgejo-mcp spec (#17) is written in.

Adds four terms the forgejo-mcp grilling surfaced, and fixes one overloaded word. - **Operator** and **Agent** (new `## People` section): `docs/agents/` and `docs/agents/domain.md` use both words throughout without ever defining them. - **Service** (under `Structure`): a program an Ansible role installs on a Guest and runs under systemd. Forgejo and the Actions runner are already two; the distinction was implicit in the architecture page only. - **LAN-reachable** / **WAN-published** (new `## Exposure` section): "exposed" was being asked to mean both at once. The pair keeps the Edge's WAN-only definition intact and makes the exposure decision explicit. Definitions only — no implementation detail, per the glossary's own rule. Context: this vocabulary is what the forgejo-mcp spec (#17) is written in.

pit added 1 commit

2026-10-06 12:04:16 +00:00

docs(glossary): add Agent, Operator, Service; split "exposed" 70bab9d6fd

The forgejo-mcp grilling turned up vocabulary the repo used without
defining: Agent (throughout docs/agents/) and Operator. It also needed a
word for what a role installs on a Guest and runs under systemd
(Service), and "exposed" was doing two jobs at once — split into
LAN-reachable and WAN-published so the exposure decision cannot be
conflated.

pit merged commit aa7cf9baa8 into main

2026-10-06 12:04:58 +00:00

pit deleted branch docs/glossary-exposure-and-agent-terms

2026-10-06 12:04:59 +00:00

pit referenced this pull request from a commit

2026-10-06 12:05:00 +00:00

docs(glossary): add Agent, Operator, Service; split "exposed" (#19)