diff --git a/contrib/pyln-client/pyln/client/gossmap.py b/contrib/pyln-client/pyln/client/gossmap.py
index ff49583f0755..5d3ee727efbb 100755
--- a/contrib/pyln-client/pyln/client/gossmap.py
+++ b/contrib/pyln-client/pyln/client/gossmap.py
@@ -38,6 +38,7 @@ class point(bytes):
 
 
 class GossmapChannel(object):
+    """A channel: fields of channel_announcement are in .fields, optional updates are in .updates_fields, which can be None of there has been no channel update."""
     def __init__(self,
                  fields: Dict[str, Any],
                  announce_offset: int,
@@ -56,6 +57,10 @@ def __init__(self,
 
 
 class GossmapNode(object):
+    """A node: fields of node_announcement are in .announce_fields, which can be None of there has been no node announcement.
+
+.channels is a list of the GossmapChannels attached to this node.
+"""
     def __init__(self, node_id: point):
         self.announce_fields: Optional[Dict[str, Any]] = None
         self.announce_offset = None
@@ -127,6 +132,7 @@ def add_node_announcement(self, rec: bytes, off: int):
         self.nodes[fields['node_id']].announce_offset = off
 
     def reopen_store(self):
+        """FIXME: Implement!"""
         assert False
 
     def remove_channel_by_deletemsg(self, rec: bytes):