docs/dev/pos-integration: more about rewards products and commissions

documentation/dev/src/explore/design/ledger/pos-integration.md

@@ -17,9 +17,9 @@ All [the data relevant to the PoS system](https://specs.namada.net/economics/pro
   - `validator/{validator_address}/total_deltas`: sum of self-bonds and delegations to this validator, may contain negative delta values when unbonding
   - `validator/{validator_address}/total_unbonded`: sum of unbonded bonds from this validator, needed to determine the amount slashed in each epoch that it affects when a slash is applied
   - `validator/{validator_address}/voting_power`
-  - `validator/{validator_address}/validator_rewards_product`: a multiplier of the `total_deltas` that yields the updated amount with staking rewards added to this validator
-  - `validator/{validator_address}/delegation_rewards_product`: similar to `validator_rewards_product`, but with delegation commissions are subtracted
-  - `validator/{validator_address}/commissions`: the total amount of delegations commissions collected by this validator
+  - `validator/{validator_address}/validator_rewards_product`: a rewards product that is used to find the updated amount for self-bonds with staking rewards added to this validator - the past epoched data has to be kept indefinitely
+  - `validator/{validator_address}/delegation_rewards_product`: similar to `validator_rewards_product`, but for delegations with commissions subtracted - the past epoched data also has to be kept indefinitely
+  - `validator/{validator_address}/commissions`: the total amount of delegations commissions collected by this validator - this doesn't need to epoched data, just an accumulator of the total
   - `validator/{validator_address}/commission_rate`: a validator chosen commission rate that is a fraction of delegation rewards charged by this validator
 - `slash/{validator_address}` (optional): a list of slashes, where each record contains epoch and slash rate
 - `bond/{bond_source}/{bond_validator} (optional)`