corrected variable references and improved formatting

Author: tedliosu

README.md

@@ -14,7 +14,7 @@
    correctly. Python's built-in "sorted" function is used to check the correctness of
    each implementation.
 
-5. You may tweak the `length_of_string` and `length_of_string_list` global variables within
+5. You may tweak the `LENGTH_OF_STRING` and `LENGTH_OF_STRING_LIST` global variables within
    the main "parallel_vs_serial_sort.py" file to see how each sorting algorithm/function
    operates under various different parameters. The ONLY stipulations on each of those global
    variables' value is that each of them must be a non-negative integer.

parallel_quicksort.py

@@ -13,11 +13,19 @@
 #
 ########################################################
 
+
+## IMPORTS SECTION ##
+
 # For parallelizing quicksort
 import multiprocessing
 # Personal implementation of serial partitioning and quicksort
 from serial_quicksort import serial_quicksort, partition
 
+## END IMPORTS SECTION ##
+
+
+## BEGIN FUNCTIONS DECLARATIONS SECTION ##
+
 # Parameter details:
 # - a_list: list to be sorted using parallel quicksort
 # - sending_socket: the end of the inter-processes communication pipe
@@ -139,5 +147,6 @@ def parallel_quicksort(a_list, sending_socket, current_processes_count,
         sending_socket.send(a_list)
         sending_socket.close()
 
+## END FUNCTIONS DECLARATIONS SECTION ##
 
 

serial_quicksort.py

@@ -12,6 +12,8 @@
 ########################################################
 
 
+## BEGIN FUNCTIONS DECLARATIONS SECTION ##
+
 # Parameter details:
 # - a_list: list to be sorted in ascending order
 #           via serial quicksort; this function
@@ -51,7 +53,6 @@ def serial_quicksort(a_list):
         a_list.append(partitioning_element)
         a_list.extend(larger_than_list)
 
-
 # Parameter details:
 # - a_list: list to be partitioned into two parts: entries greater
 #           than "partitioner" and entries less than "partitioner";
@@ -83,3 +84,6 @@ def partition(a_list, no_larger_than_list, larger_than_list, partitioner):
         else:
             no_larger_than_list.append(element)
 
+## END FUNCTIONS DECLARATIONS SECTION ##
+
+