m

Author: ajewellamz

specification/changes/2025-08-25-beacon-partitions/background.md

@@ -1,9 +1,9 @@
 [//]: # "Copyright Amazon.com Inc. or its affiliates. All Rights Reserved."
 [//]: # "SPDX-License-Identifier: CC-BY-SA-4.0"
 
-# Partition Beacons
+# Beacon Partitions
 
-`Partition Beacons` refers to a way to add a little bit more randomness to your [beacons](../../searchable-encryption/beacons.md),
+`Beacon Partitions` refers to a way to add a little bit more randomness to your [beacons](../../searchable-encryption/beacons.md),
 to add anonymity when your data distribution is uneven
 
 Probably read [changes](./change.md) first, as it gives a brief overview of the interface.
@@ -23,7 +23,7 @@ In this case, some hashes will have many many occurrences, and some will have on
 
 An external observer can look at census data and make an educated guess that the hashes with many occurrences are probably "Jones" or "Smith". Pretty soon, you've leaked real information.
 
-## Introducing Partition Beacons
+## Introducing Beacon Partitions
 
 One strategy to combat this is to further divide each item's beacons into separate `partitions`,
 so that the same value in different records might produce different hashes.
@@ -60,12 +60,12 @@ with four of the queries returning nothing.
 
 ### Performance Advantages
 
-On the other hand, partition beacons can provide performance enhancements as well.
+On the other hand, beacon partitions can provide performance enhancements as well.
 
 Sometimes a common value can share the same hash as a rare one.
 In this case, a search for the rare one pays the penalty of retrieving and discarding all the
 matches for the common one.
-Partition beacon reduces the maximum number occurrences of a single hash, reducing this penalty.
+Beacon partitions reduce the maximum number occurrences of a single hash, reducing this penalty.
 
 Increasing the number of partitions can allow you to increase the length of a standard beacon,
 further decreasing the number of results that must be retrieved and discarded.

specification/changes/2025-08-25-beacon-partitions/change.md

@@ -1,7 +1,7 @@
 [//]: # "Copyright Amazon.com Inc. or its affiliates. All Rights Reserved."
 [//]: # "SPDX-License-Identifier: CC-BY-SA-4.0"
 
-# Partition Beacons
+# Beacon Partitions
 
 ## New Types
 

specification/dynamodb-encryption-client/ddb-get-number-of-queries.md

@@ -5,7 +5,7 @@
 
 ## Overview
 
-When using [Partition Beacons](../changes/2025-08-25-partition-beacons/background.md),
+When using [Beacon Partitions](../changes/2025-08-25-partition-beacons/background.md),
 more than one [query](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html)
 can be necessary to retrieve all of the desired results,
 leading to code something like this:

specification/dynamodb-encryption-client/ddb-support.md

@@ -190,7 +190,7 @@ MUST be obtained from the [Beacon Key Materials](../searchable-encryption/search
 [HMAC Keys map](../searchable-encryption/search-config.md#hmac-keys) using the beacon name
 as the key.
 
-If [Partition Beacons](../changes/2025-08-25-partition-beacons/background.md) are being used,
+If [Beacon Partitions](../changes/2025-08-25-partition-beacons/background.md) are being used,
 then the [FilterExpression](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.FilterExpression.html) must be augmented as described in [Filter Expressions for Query](#filter-expressions-for-query).
 
 For example if the query is

specification/searchable-encryption/beacons.md

@@ -10,7 +10,7 @@
 ### Changelog
 
 - 1.1.0
-  - add partition beacons
+  - add beacon partitions
 
 ## Conventions used in this document
 
@@ -491,15 +491,15 @@ Both standard and compound beacons define two operations
 
 - This operation MUST convert the attribute value of the associated field to
   a sequence of bytes, as per [attribute serialization](../dynamodb-encryption-client/ddb-attribute-serialization.md).
-- The serialized form MUST be augmented as per [partition beacon encoding](#partition-beacon-encoding).
+- The serialized form MUST be augmented as per [beacon partition encoding](#partition-beacon-encoding).
 - This operation MUST return the [basicHash](#basichash) of the resulting bytes and the configured [beacon length](#beacon-length).
 - The returned
   [AttributeValue](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_AttributeValue.html)
   MUST be type "S" String.
 
-#### Partition Beacon Encoding
+#### Beacon Partition Encoding
 
-Partition Beacon Encoding converts a sequence of bytes into a possibly different sequence of bytes.
+Beacon Partition Encoding converts a sequence of bytes into a possibly different sequence of bytes.
 
 To calculate the [partition number](search-config.md#partitionnumber) for this beacon by calculating `X % N`
 where `X` is the partition specified and `N` is the [number of partitions](#beacon-constraint) specified for the beacon.

specification/searchable-encryption/search-config.md

@@ -6,7 +6,7 @@
 ## Version
 
 - 1.2.0
-  - Add partition beacons
+  - Add beacon partitions
 - 1.1.0
   - [Update Cache Entry Identifier Formulas to shared cache across multiple Beacon Key Sources](../../changes/2024-09-13_cache-across-hierarchical-keyrings/change.md)
   - New optional parameter `Partition ID` used to distinguish Cryptographic Material Providers (i.e: Beacon Key Sources) writing to a cache
@@ -530,10 +530,10 @@ Now, two [beacon versions](#beacon-version-initialization) (BV1 and BV2) are cre
 
 Notice that both K1 and K2 are clients for the same physical Key Store (K).
 
-## Partition Beacons
+## Beacon Partitions
 
-`Partition Beacons` refers to a way to add a little bit more randomness to your [beacons](../../searchable-encryption/beacons.md),
-to add anonymity when your data distribution is uneven. See [partition beacon background](../changes/2025-08-25-partition-beacons/background.md).
+`Beacon Partitions` refers to a way to add a little bit more randomness to your [beacons](../../searchable-encryption/beacons.md),
+to add anonymity when your data distribution is uneven. See [beacon partition background](../changes/2025-08-25-partition-beacons/background.md).
 
 ### PartitionCount