diff --git a/README.md b/README.md
index f14f367..610266b 100644
--- a/README.md
+++ b/README.md
@@ -70,3 +70,5 @@ docker build -t statusteam/auto-sticker-pinner:latest .
 
 * Currently IPFS Cluster API does not expose any info about possible pinning errors
   - We run `GET /pin/{chash}` to check if it was pinned as an alternative
+* Checking pin status for a cluster returns multiple statuses
+  - We check if all of them are of certain type, and ignore other mixed states
diff --git a/ipfs.py b/ipfs.py
index b47e6fa..1c63d27 100644
--- a/ipfs.py
+++ b/ipfs.py
@@ -22,6 +22,7 @@ class IpfsPinner:
             peer in self.ls(chash)['peer_map'].values()
         ]
 
+    # See: https://cluster.ipfs.io/documentation/guides/pinning/
     def status(self, chash):
         statuses = self.statuses(chash)
         if all(s == 'pinned' for s in statuses):