diff --git a/conf/server-base.conf b/conf/server-base.conf
index 3c6c67cf0..2f03b11b2 100644
--- a/conf/server-base.conf
+++ b/conf/server-base.conf
@@ -26,6 +26,9 @@ location /realtime {
     proxy_request_buffering off;
 }
 
+# At the begining and end of a push/pull, /v1/repositories is hit by the Docker
+# client. By rate-limiting just this endpoint, we can avoid accidentally
+# blocking pulls/pushes for images with many layers.
 location /v1/repositories/ {
     proxy_buffering off;