From 8ad62052003a2492ccb3efc88af873f30780391a Mon Sep 17 00:00:00 2001 From: unkin-agent Date: Sat, 5 Sep 2026 11:56:50 +1000 Subject: [PATCH] docs: reword reports/events union without old/new framing --- README.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 9406085..510ba51 100644 --- a/README.md +++ b/README.md @@ -56,11 +56,10 @@ unknown fields survive untouched. - A node present in only one backend always appears (falls back to whichever backend actually returned facts for it). - **`/reports`, `/events`** — **union**, not a per-node winner. Reports are - immutable history, so a node that moved between PuppetDBs legitimately has - reports in both and both belong in the merged view. Reports dedupe - on `hash`; events, which carry no id of their own, dedupe on the verbatim - record (a node briefly reporting to both PuppetDBs stores identical records in - each). + immutable history, so a node's reports can legitimately exist in more than one + backend and all of them belong in the merged view. Reports dedupe on `hash`; + events, which carry no id of their own, dedupe on the verbatim record (a node + reporting to more than one backend stores identical records in each). - **Aggregates** — `extract`/`group_by` rows are counts, not records, so each backend returns a partial answer that has to be **added**, not deduped. This covers `/event-counts`, `/aggregate-event-counts`, and a `/reports` query whose