Update comments

synapse/handlers/federation.py

@@ -127,7 +127,7 @@ class FederationHandler(BaseHandler):
 
         # If we're no longer in the room just ditch the event entirely. This
         # is probably an old server that has come back and thinks we're still
-        # in the room.
+        # in the room (or we've been rejoined to the room by a state reset).
         #
         # If we were never in the room then maybe our database got vaped and
         # we should check if we *are* in fact in the room. If we are then we

synapse/storage/roommember.py

@@ -536,6 +536,13 @@ class RoomMemberStore(SQLBaseStore):
     @cachedInlineCallbacks()
     def was_host_joined(self, room_id, host):
         """Check whether the server is or ever was in the room.
+
+        Args:
+            room_id (str)
+            host (str)
+
+        Returns:
+            bool: whether the host is/was in the room or not
         """
         if '%' in host or '_' in host:
             raise Exception("Invalid host name")