diff --git a/config/initializers/static_files.rb b/config/initializers/static_files.rb
index 2a6eaec0cc43b9aa9b1e004939cb58dfd2007156..bc4fe14bc1ae4ea2b84eef54f2f083086b553a6f 100644
--- a/config/initializers/static_files.rb
+++ b/config/initializers/static_files.rb
@@ -1,6 +1,11 @@
 begin
   app = Rails.application
 
+  # The `ActionDispatch::Static` middleware intercepts requests for static files 
+  # by checking if they exist in the `/public` directory. 
+  # We're replacing it with our `Gitlab::Middleware::Static` that does the same,
+  # except ignoring `/uploads`, letting those go through to the GitLab Rails app.
+
   app.config.middleware.swap(
     ActionDispatch::Static, 
     Gitlab::Middleware::Static,