Align note comments to use complete sentences

specs/bellatrix/fork-choice.md

@@ -81,7 +81,7 @@ EIP-3675, before a post-transition block is finalized,
 `finalized_block_hash = Hash32()`.
 
 *Note*: Client software MUST NOT call this function until the transition
-conditions are met on the PoW network, i.e. there exists a block for which
+conditions are met on the PoW network, i.e. there exists a block for which the
 `is_valid_terminal_pow_block` function returns `True`.
 
 *Note*: Client software MUST call this function to initiate the payload build

specs/bellatrix/validator.md

@@ -87,22 +87,23 @@ avoid requiring simple serialize hashing capabilities in the execution layer.
 
 ### `ExecutionEngine`
 
-*Note*: `get_payload` function is added to the `ExecutionEngine` protocol for
-use as a validator.
+*Note*: The `get_payload` function is added to the `ExecutionEngine` protocol
+for use as a validator.
 
 The body of this function is implementation dependent. The Engine API may be
 used to implement it with an external execution engine.
 
 #### `get_payload`
 
-Given the `payload_id`, `get_payload` returns `GetPayloadResponse` with the most
-recent version of the execution payload that has been built since the
-corresponding call to `notify_forkchoice_updated` method.
+*Note*: Given the `payload_id`, the `get_payload` function returns
+`GetPayloadResponse` with the most recent version of the execution payload that
+has been built since the corresponding call to `notify_forkchoice_updated`
+method.
 
 ```python
 def get_payload(self: ExecutionEngine, payload_id: PayloadId) -> GetPayloadResponse:
     """
-    Return ``GetPayloadResponse`` object.
+    Return ExecutionPayload object.
     """
 ```
 

specs/capella/validator.md

@@ -53,7 +53,15 @@ class GetPayloadResponse:
 
 #### Modified `get_payload`
 
-`get_payload` returns the upgraded Capella `ExecutionPayload` type.
+*Note*: The `get_payload` function returns the updated `GetPayloadResponse`
+object.
+
+```python
+def get_payload(self: ExecutionEngine, payload_id: PayloadId) -> GetPayloadResponse:
+    """
+    Return ExecutionPayload and uint256 objects.
+    """
+```
 
 ## Beacon chain responsibilities
 

specs/deneb/validator.md

@@ -81,14 +81,13 @@ def compute_signed_block_header(signed_block: SignedBeaconBlock) -> SignedBeacon
 
 #### Modified `get_payload`
 
-Given the `payload_id`, `get_payload` returns the most recent version of the
-execution payload that has been built since the corresponding call to
-`notify_forkchoice_updated` method.
+*Note*: The `get_payload` function returns the updated `GetPayloadResponse`
+object.
 
 ```python
 def get_payload(self: ExecutionEngine, payload_id: PayloadId) -> GetPayloadResponse:
     """
-    Return ExecutionPayload, uint256, BlobsBundle objects.
+    Return ExecutionPayload, uint256, and BlobsBundle objects.
     """
 ```
 

specs/electra/validator.md

@@ -88,14 +88,13 @@ class SignedAggregateAndProof(Container):
 
 #### Modified `get_payload`
 
-Given the `payload_id`, `get_payload` returns the most recent version of the
-execution payload that has been built since the corresponding call to
-`notify_forkchoice_updated` method.
+*Note*: The `get_payload` function returns the updated `GetPayloadResponse`
+object.
 
 ```python
 def get_payload(self: ExecutionEngine, payload_id: PayloadId) -> GetPayloadResponse:
     """
-    Return ExecutionPayload, uint256, BlobsBundle and execution requests (as Sequence[bytes]) objects.
+    Return ExecutionPayload, uint256, BlobsBundle, and execution requests (as Sequence[bytes]) objects.
     """
 ```
 

specs/fulu/validator.md

@@ -91,13 +91,13 @@ class GetPayloadResponse:
 
 #### Modified `get_payload`
 
-The `get_payload` method is modified to return the updated `GetPayloadResponse`
+*Note*: The `get_payload` function returns the updated `GetPayloadResponse`
 object.
 
 ```python
 def get_payload(self: ExecutionEngine, payload_id: PayloadId) -> GetPayloadResponse:
     """
-    Return ExecutionPayload, uint256, BlobsBundle objects.
+    Return ExecutionPayload, uint256, BlobsBundle, and execution requests (as Sequence[bytes]) objects.
     """
 ```
 

specs/heze/validator.md

@@ -44,22 +44,22 @@ class GetInclusionListResponse:
 
 ### `ExecutionEngine`
 
-*Note*: `get_inclusion_list` function is added to the `ExecutionEngine` protocol
-for use as an inclusion list committee member.
+*Note*: The `get_inclusion_list` function is added to the `ExecutionEngine`
+protocol for use as an inclusion list committee member.
 
 The body of this function is implementation dependent. The Engine API may be
 used to implement it with an external execution engine.
 
 #### New `get_inclusion_list`
 
-`get_inclusion_list` returns `GetInclusionListResponse` with the most recent
-inclusion list transactions that has been built based on the latest view of the
-public mempool.
+*Note*: `get_inclusion_list` returns `GetInclusionListResponse` with the most
+recent inclusion list transactions that has been built based on the latest view
+of the public mempool.
 
 ```python
 def get_inclusion_list(self: ExecutionEngine) -> GetInclusionListResponse:
     """
-    Return ``GetInclusionListResponse`` object.
+    Return inclusion list transactions (as Sequence[Transaction]) object.
     """
 ```