Python: Update comments for Kinesis GetRecords (#7058)

* Adding better description to the get_records function.

Author: rlhagerm

.doc_gen/metadata/kinesis_metadata.yaml

@@ -265,6 +265,7 @@ kinesis_GetRecords:
               snippet_tags:
                 - python.example_code.kinesis.KinesisStream.class
                 - python.example_code.kinesis.GetRecords
+                - python.example_code.kinesis.DescribeStream
     SAP ABAP:
       versions:
         - sdk_version: 1

python/example_code/kinesis/streams/kinesis_stream.py

@@ -130,8 +130,10 @@ def get_records(self, max_records):
         """
         Gets records from the stream. This function is a generator that first gets
         a shard iterator for the stream, then uses the shard iterator to get records
-        in batches from the stream. Each batch of records is yielded back to the
-        caller until the specified maximum number of records has been retrieved.
+        in batches from the stream. The shard iterator can be accessed through the
+        'details' property, which is populated using the 'describe' function of this class.
+        Each batch of records is yielded back to the caller until the specified
+        maximum number of records has been retrieved.
 
         :param max_records: The maximum number of records to retrieve.
         :return: Yields the current batch of retrieved records.