diff --git a/services/chat/app/coffee/Features/WebApi/WebApiManager.coffee b/services/chat/app/coffee/Features/WebApi/WebApiManager.coffee
index e5e1b5c553..38a44ea19c 100644
--- a/services/chat/app/coffee/Features/WebApi/WebApiManager.coffee
+++ b/services/chat/app/coffee/Features/WebApi/WebApiManager.coffee
@@ -1,6 +1,11 @@
 request = require('request').defaults(jar: false)
 Settings = require("settings-sharelatex")
 
+# DEPRECATED! This method of getting user details via chat is deprecated
+# in the way we lay out our services.
+# Instead, web should be responsible for collecting the raw data (user_ids) and
+# filling it out with calls to other services. All API calls should create a
+# tree-like structure as much as possible, with web as the root.
 module.exports = WebApiManager =
 	apiRequest: (url, method, options = {}, callback = (error, result) ->) ->
 		if typeof options == "function"