Added more documentation

droid/script.py

@@ -54,7 +54,6 @@ def __init__(self, droid: object) -> None:
 
         Args:
             droid (object): The droid instance to use.
-
         """
 
         self.droid = droid
@@ -135,6 +134,9 @@ async def close_script(self, script_id: int = 0) -> None:
     def __calculate_reaction_time(self, interval: int) -> int:
         """
         Calculates the time in seconds from a park beacon's reaction interval.
+
+        Args:
+            interval (int): Reaction interval received from a location beacon
         """
 
         interval = interval * 5
@@ -145,6 +147,13 @@ def __calculate_reaction_time(self, interval: int) -> int:
 
     async def __perform_droid_location_reactions(self, locations: list) -> None:
         """
+        Executes a script associated with each park location beacon that the droid enters.
+
+        Args:
+            locations (list): A list of location beacon addresses to react to
+
+        Returns:
+            int: The calculated reaction time in seconds.
         """
 
         # Verify we have at least one location to react to first.

droid/voice.py

@@ -1,4 +1,15 @@
 """
+This module provides a voice controller for SWGE droids that attempts to match the droid's configured affiliation
+to a tone of voice based on the available audio banks in the droid's memory. 
+
+It contains a `DroidVoiceController` class that has methods to get voice bank IDs for different tones of 
+voice based on the droid's affiliation. 
+
+The `DroidVoiceTone` class defines identifiers for the possible tones of voice to use when speaking. 
+The `talk_with_animation` method of the `DroidVoiceController` class sends a command to the droid to speak with a random animation and audio file
+based around the tone supplied when invoked.
+
+This code is MIT licensed.
 """
 
 from droid.hardware import DroidAffiliation, DroidAudioBankIdentifier