permission-node: deprecate createPermisisonIntegrationRouter + docs fix

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>

plugins/permission-node/src/integration/createPermissionIntegrationRouter.ts

@@ -201,6 +201,7 @@ export function createConditionAuthorizer<TResource, TQuery>(
  * for a particular resource type.
  *
  * @public
+ * @deprecated {@link createPermissionIntegrationRouter} is deprecated
  */
 export type CreatePermissionIntegrationRouterResourceOptions<
   TResourceType extends string,
@@ -223,6 +224,7 @@ export type CreatePermissionIntegrationRouterResourceOptions<
  * permissions and rules from multiple resource types.
  *
  * @public
+ * @deprecated {@link createPermissionIntegrationRouter} is deprecated
  */
 export type PermissionIntegrationRouterOptions<
   TResourceType1 extends string = string,
@@ -410,6 +412,7 @@ class PermissionIntegrationMetadataStore {
  * need to be evaluated.
  *
  * @public
+ * @deprecated use `PermissionRegistryService` instead, see {@link https://backstage.io/docs/backend-system/core-services/permissions-registry#migrating-from-createpermissionintegrationrouter | the migration section in the service docs} for more details.
  */
 export function createPermissionIntegrationRouter<
   TResourceType1 extends string,