From 582d75328f1a3a71d2ff3f9d88cf8a1a36d644b8 Mon Sep 17 00:00:00 2001
From: James McKinney <26463+jpmckinney@users.noreply.github.com>
Date: Thu, 19 Sep 2024 12:37:26 -0400
Subject: [PATCH] docs(powerbi): Clarify result table

---
 docs/reference/powerbi.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/powerbi.rst b/docs/reference/powerbi.rst
index 980a22d5..f7d7a2c2 100644
--- a/docs/reference/powerbi.rst
+++ b/docs/reference/powerbi.rst
@@ -25,9 +25,9 @@ Cardinal's `indicators command <https://cardinal.readthedocs.io/en/latest/cli/in
    :start-after: CREATE
    :end-before: );
 
--  An indicator triggers at most once per entity (``ocid``, ``buyer_id``, ``procuring_entity_id`` or ``tenderer_id``). However, we “spread” the non-OCID results across multiple contracting processes. So, the unique key (if we were to add one) would be (``ocid``, ``code``, ``buyer_id``, ``procuring_entity_id``, ``tenderer_id``).
+-  For each indicator, Cardinal flags each entity at most once. An entity can be a contracting process (``ocid``), buyer (``buyer_id``), procuring entity (``procuring_entity_id``) or tenderer (``tenderer_id``). However, in this SQL table, if the entity is not a contracting process (``ocid``), then the indicator result is “spread” across the entity's related contracting processes. For example, if the NF038 indicator flags a buyer, then a row is added for each contracting process of that buyer. If we were to add a unique key, it would be: (``ocid``, ``code``, ``buyer_id``, ``procuring_entity_id``, ``tenderer_id``).
 
--  Each row is about only one entity. For example, if a contracting process is flagged (``ocid``) and the same contracting process has both a buyer that is flagged (``buyer_id``) and a tenderer that is flagged (``tenderer_id``), there will be 3 rows, not 1. For example:
+-  Each row is "about" only one entity, indicated by the ``subject`` column. For example, if a contracting process is flagged (``ocid``) and the same contracting process has both a buyer that is flagged (``buyer_id``) and a tenderer that is flagged (``tenderer_id``), there will be 3 rows, not 1. For example:
 
    ============= ======== ===== ======== ===========
    ocid          subject  code  buyer_id tenderer_id