docs: improve docstring

Author: pedroferreira1

hathor/indexes/address_index.py

@@ -95,8 +95,8 @@ def get_from_address(self, address: str) -> list[bytes]:
     def get_sorted_from_address(self, address: str, tx_start: Optional[BaseTransaction] = None) -> Iterable[bytes]:
         """ Get a sorted list of transaction hashes of an address
 
-        The parameter tx_start means the transaction from which the iterator will start, and it is used for pagination.
-        When it's None it means that the iterator will start from the beginning.
+        `tx_start` serves as a pagination marker, indicating the starting position for the iteration.
+        When tx_start is None, the iteration begins from the initial element.
         """
         raise NotImplementedError
 

hathor/indexes/tx_group_index.py

@@ -52,8 +52,8 @@ def _get_from_key(self, key: KT) -> Iterable[bytes]:
     def _get_sorted_from_key(self, key: KT, tx_start: Optional[BaseTransaction] = None) -> Iterable[bytes]:
         """Get all transactions that have a given key, sorted by timestamp.
 
-        The parameter tx_start means the transaction from which the iterator will start, and it is used for pagination.
-        When it's None it means that the iterator will start from the beginning.
+        `tx_start` serves as a pagination marker, indicating the starting position for the iteration.
+        When tx_start is None, the iteration begins from the initial element.
         """
         raise NotImplementedError