address pr feedback

Author: legrego

x-pack/plugins/security/server/authorization/disable_ui_capabilities.ts

@@ -18,6 +18,10 @@ export function disableUICapabilitiesFactory(
   logger: Logger,
   authz: AuthorizationServiceSetup
 ) {
+  // nav links are sourced from two places:
+  // 1) The `navLinkId` property. This is deprecated and will be removed (https://github.com/elastic/kibana/issues/66217)
+  // 2) The apps property. The Kibana Platform associates nav links to the app which registers it, in a 1:1 relationship.
+  //    This behavior is replacing the `navLinkId` property above.
   const featureNavLinkIds = features
     .flatMap((feature) => [feature.navLinkId, ...feature.app])
     .filter((navLinkId) => navLinkId != null);