diff --git a/compose/rest/settings.go b/compose/rest/settings.go
index 0846d0040..91e36a50d 100644
--- a/compose/rest/settings.go
+++ b/compose/rest/settings.go
@@ -47,6 +47,9 @@ func (ctrl *Settings) Get(ctx context.Context, r *request.SettingsGet) (interfac
 	}
 }
 
+// Current settings, structured
+//
+// This is available to all authenticated users
 func (ctrl *Settings) Current(ctx context.Context, r *request.SettingsCurrent) (interface{}, error) {
 	return service.CurrentSettings, nil
 }
diff --git a/messaging/rest/settings.go b/messaging/rest/settings.go
index dc0359d8b..42328d2d5 100644
--- a/messaging/rest/settings.go
+++ b/messaging/rest/settings.go
@@ -47,6 +47,11 @@ func (ctrl *Settings) Get(ctx context.Context, r *request.SettingsGet) (interfac
 	}
 }
 
+// Current settings, structured
+//
+// This is available to all authenticated users
+//
+// @todo selectively apply subset of user's own settings (like ui.*)
 func (ctrl *Settings) Current(ctx context.Context, r *request.SettingsCurrent) (interface{}, error) {
 	return service.CurrentSettings, nil
 }
diff --git a/system/rest/settings.go b/system/rest/settings.go
index 297a8de05..7cc3a4cb8 100644
--- a/system/rest/settings.go
+++ b/system/rest/settings.go
@@ -47,6 +47,11 @@ func (ctrl *Settings) Get(ctx context.Context, r *request.SettingsGet) (interfac
 	}
 }
 
+// Current settings, structured
+//
+// This is available to all authenticated users
+//
+// @todo selectively apply subset of user's own settings (like ui.one.panes.*)
 func (ctrl *Settings) Current(ctx context.Context, r *request.SettingsCurrent) (interface{}, error) {
 	return service.CurrentSettings, nil
 }