Merge pull request #44 from ASPP/comment-rewrites

Author: Debilski

demo06_switching_bots.py

@@ -1,4 +1,10 @@
-# This bot switches its personality when one guy dies
+# This demo shows how to combine the strategies of the basic attacker and the
+# basic defender
+# Initially, one bot is in attack mode, while the other uses the defending
+# strategy. Once the attacking bot is killed, it restarts as a defender, while
+# the previous defender changes its personality and becomes the new attacker.
+
+
 TEAM_NAME = 'Switching Bots'
 
 import networkx
@@ -10,17 +16,22 @@
 
 def init_state(personality):
     return {
+        # specifies which personality we are: "attacker" or "defender"
         "personality": personality,
+
+        # entries prefixed with "attack_" are used by the move_attacker function
         "attack_target": None,
+        "attack_path": None,
+
+        # entries prefixed with "defend_" are used by the move_defender function
         "defend_target": None,
         "defend_path": None,
-        "attack_path": None,
     }
 
 def move(bot, state):
     # Keep two "substates" — one for each bot
     if state == {}:
-        # here each bopt has its own state dictionary (0 and 1) and they share
+        # here each bot has its own state dictionary (0 and 1) and they share
         # the same game state information in the "graph"
         state['graph'] = walls_to_graph(bot.walls)
         state[0] = init_state("attacker")