Added and polished some comments

Author: stktung

sample_append.py

@@ -21,14 +21,14 @@
     data=b'{"Id":"1", "importantData":"some value"}'  # Specify the event data body as a JSON in byte format
 )
 
-########################################################
+##################################################
 #
-# Step 3. Append the event object into the SampleStream
+# Step 3. Append the event object into the stream
 #
-########################################################
+##################################################
 
 event_stream = "SampleStream"        # Define the stream name where the event will be appended
-client.append_to_stream(             # Append the event to the SampleStream
+client.append_to_stream(             # Append the event to a stream
     event_stream,                    # Name of the stream to append the event to
     events=[new_event],              # The event to append (in a list)
     current_version=StreamState.ANY  # Set to append regardless of the current stream state (you can ignore this for now)

sample_read.py

@@ -9,11 +9,11 @@
 # Create an instance of EventStoreDBClient, connecting to the EventStoreDB at localhost without TLS
 client = EventStoreDBClient(uri="esdb://localhost:2113?tls=false")
 
-################################################
+##########################################
 #
-# Step 2. Read all events from the SampleStream
+# Step 2. Read all events from the stream
 #
-################################################
+##########################################
 
 events = client.get_stream("SampleStream")  # Read all events from SampleStream
 
@@ -23,12 +23,12 @@
 #
 ######################################
 
-for event in events:
-    print("************************");
-    print("You have read an event!");
-    print("Stream: " + event.stream_name);
-    print("Event Type: " + event.type);
-    print("Event Body: " + event.data.decode());
+for event in events:                              # For each event
+    print("************************");            #
+    print("You have read an event!");             #
+    print("Stream: " + event.stream_name);        # Print the stream name of the event
+    print("Event Type: " + event.type);           # Print the type of the event
+    print("Event Body: " + event.data.decode());  # Print the body of the event after converting it to string from a byte array
     print("************************");
 
 client.close()