incorporate @mcdee's phrasing

Author: tersec

apis/beacon/rewards/blocks.yaml

@@ -2,9 +2,9 @@ get:
   operationId: getBlockRewards
   summary: Get block rewards
   description: |
-    Retrieve block reward info for a single block. This reward consists of the reward
-    accruing specifically to the block proposer in its proposer role, rather than any
-    other roles it might additionally have in that block.
+    Retrieve block reward info for a single block. The rewards value is the sum
+    of values of the proposer rewards from attestations, sync committees and
+    slashings included in the proposal.
   tags:
     - Beacon
     - Rewards

beacon-node-oapi.yaml

@@ -486,8 +486,11 @@ components:
         $ref: './types/primitive.yaml#/Wei'
     Eth-Consensus-Block-Value:
       description: |
-        Consensus rewards for this block in Wei paid to the proposer, attributable specifically to its role as
-        proposer. Required in response so client can determine relative value of consensus blocks.
+        Consensus rewards for this block in Wei paid to the proposer. The
+        rewards value is the sum of values of the proposer rewards from
+        attestations, sync committees and slashings included in the proposal.
+        Required in response so client can determine relative value of
+        consensus blocks.
       required: true
       schema:
         $ref: './types/primitive.yaml#/Wei'