fix: Remove 111 cross-section redirects, generate CSV for GitBook UI

Space-level redirects in .gitbook.yaml can only target pages within
the same section. The 111 cross-section redirects (api-clients/ → api/,
device-guides/ → brand-guides/) were silently 404ing.

These are exported to cross-section-redirects.csv for import as
site-level redirects via the GitBook UI.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: louis-pre

.gitbook.yaml

@@ -21,116 +21,5 @@ redirects:
   products/access-systems/suspending-and-unsuspending-users: capability-guides/access-systems/user-management/suspending-and-unsuspending-users.md
   products/seam-bridge-in-development: capability-guides/seam-bridge.md
   core-concepts/connect-webviews: core-concepts/connect-webviews/README.md
-  device-guides/4suites-locks: device-and-system-integration-guides/4suites-locks/README.md
-  device-guides/assa-abloy-visionline-access-control-system-in-development: device-and-system-integration-guides/assa-abloy-visionline-access-control-system/README.md
-  device-guides/assa-abloy-visionline-access-control-system-in-development/credential-types: device-and-system-integration-guides/assa-abloy-visionline-access-control-system/README.md
-  device-guides/assa-abloy-visionline-access-control-system-in-development/common-use-cases: device-and-system-integration-guides/assa-abloy-visionline-access-control-system/common-use-cases.md
   capability-guides/access-systems/understanding-acs-differences: capability-guides/access-systems/README.md
   capability-guides/thermostats/creating-and-managing-climate-schedules: capability-guides/thermostats/creating-and-managing-thermostat-schedules.md
-  device-guides/get-started-with-schlage-locks: device-and-system-integration-guides/schlage-locks/get-started-with-schlage-locks.md
-  api-clients/access-codes/convert-an-unmanaged-access-code: api/access_codes/unmanaged/convert_to_managed.md
-  api-clients/access-codes/create-an-access-code: api/access_codes/create.md
-  api-clients/access-codes/create-many-access-codes: api/access_codes/create_multiple.md
-  api-clients/access-codes/delete-an-access-code: api/access_codes/delete.md
-  api-clients/access-codes/delete-an-unmanaged-access-code: api/access_codes/unmanaged/delete.md
-  api-clients/access-codes/get-an-access-code: api/access_codes/get.md
-  api-clients/access-codes/get-an-unmanaged-access-code: api/access_codes/unmanaged/get.md
-  api-clients/access-codes/list-access-codes: api/access_codes/list.md
-  api-clients/access-codes/list-unmanaged-access-codes: api/access_codes/unmanaged/list.md
-  api-clients/access-codes/pull-backup-access-code: api/access_codes/pull_backup_access_code.md
-  api-clients/access-codes/update-an-access-code: api/access_codes/update.md
-  api-clients/access-codes: api/access_codes/README.md
-  api-clients/access-control-systems/access-groups/add-user-to-access-group: api/acs/access_groups/add_user.md
-  api-clients/access-control-systems/access-groups/get-access-group: api/acs/access_groups/get.md
-  api-clients/access-control-systems/access-groups/list-access-groups: api/acs/access_groups/list.md
-  api-clients/access-control-systems/access-groups/list-users-in-access-group: api/acs/access_groups/list_users.md
-  api-clients/access-control-systems/access-groups/remove-user-from-access-group: api/acs/access_groups/remove_user.md
-  api-clients/access-control-systems/access-groups: api/acs/access_groups/README.md
-  api-clients/access-control-systems/credentials/assign-a-credential-to-a-user: api/acs/credentials/assign.md
-  api-clients/access-control-systems/credentials/create-credential-for-user: api/acs/credentials/create.md
-  api-clients/access-control-systems/credentials/delete-credential: api/acs/credentials/delete.md
-  api-clients/access-control-systems/credentials/get-credential: api/acs/credentials/get.md
-  api-clients/access-control-systems/credentials/list-accessible-entrances: api/acs/credentials/list_accessible_entrances.md
-  api-clients/access-control-systems/credentials/list-credentials: api/acs/credentials/list.md
-  api-clients/access-control-systems/credentials/unassign-a-credential-from-a-user: api/acs/credentials/unassign.md
-  api-clients/access-control-systems/credentials/update-a-credential: api/acs/credentials/update.md
-  api-clients/access-control-systems/credentials: api/acs/credentials/README.md
-  api-clients/access-control-systems/entrances/get-an-entrance: api/acs/entrances/get.md
-  api-clients/access-control-systems/entrances/list-credentials-with-access-to-an-entrance: api/acs/entrances/list_credentials_with_access.md
-  api-clients/access-control-systems/entrances/list-entrances: api/acs/entrances/list.md
-  api-clients/access-control-systems/entrances: api/acs/entrances/README.md
-  api-clients/access-control-systems/systems/get-system: api/acs/systems/get.md
-  api-clients/access-control-systems/systems/list-compatible-credential-manager-acs-systems: api/acs/systems/list_compatible_credential_manager_acs_systems.md
-  api-clients/access-control-systems/systems/list-systems: api/acs/systems/list.md
-  api-clients/access-control-systems/systems: api/acs/systems/README.md
-  api-clients/access-control-systems/users/add-user-to-access-group: api/acs/users/add_to_access_group.md
-  api-clients/access-control-systems/users/create-user: api/acs/users/create.md
-  api-clients/access-control-systems/users/delete-user: api/acs/users/delete.md
-  api-clients/access-control-systems/users/get-user: api/acs/users/get.md
-  api-clients/access-control-systems/users/list-users: api/acs/users/list.md
-  api-clients/access-control-systems/users/remove-user-from-access-group: api/acs/users/remove_from_access_group.md
-  api-clients/access-control-systems/users/suspend-a-user: api/acs/users/suspend.md
-  api-clients/access-control-systems/users/unsuspend-a-user: api/acs/users/unsuspend.md
-  api-clients/access-control-systems/users/update-user: api/acs/users/update.md
-  api-clients/access-control-systems/users: api/acs/users/README.md
-  api-clients/access-control-systems: api/acs/README.md
-  api-clients/action-attempt/get-action-attempt: api/action_attempts/get.md
-  api-clients/action-attempt: api/action_attempts/README.md
-  api-clients/client-sessions/create-a-client-session: api/client_sessions/create.md
-  api-clients/client-sessions/delete-a-client-session: api/client_sessions/delete.md
-  api-clients/client-sessions/get-a-client-session: api/client_sessions/get.md
-  api-clients/client-sessions/get-or-create-a-client-session: api/client_sessions/get_or_create.md
-  api-clients/client-sessions/grant-access-to-a-client-session: api/client_sessions/grant_access.md
-  api-clients/client-sessions/list-client-sessions: api/client_sessions/list.md
-  api-clients/client-sessions: api/client_sessions/README.md
-  api-clients/connect-webviews/create-a-connect-webview: api/connect_webviews/create.md
-  api-clients/connect-webviews/delete-a-connect-webview: api/connect_webviews/delete.md
-  api-clients/connect-webviews/get-a-connect-webview: api/connect_webviews/get.md
-  api-clients/connect-webviews/list-connect-webviews: api/connect_webviews/list.md
-  api-clients/connect-webviews: api/connect_webviews/README.md
-  api-clients/connected-accounts/delete-a-connected-account: api/connected_accounts/delete.md
-  api-clients/connected-accounts/get-a-connected-account: api/connected_accounts/get.md
-  api-clients/connected-accounts/list-connected-accounts: api/connected_accounts/list.md
-  api-clients/connected-accounts/update-a-connected-account: api/connected_accounts/update.md
-  api-clients/connected-accounts: api/connected_accounts/README.md
-  api-clients/devices/delete-device: api/devices/README.md
-  api-clients/devices/get-device-1: api/devices/unmanaged/get.md
-  api-clients/devices/get-device: api/devices/get.md
-  api-clients/devices/list-device-providers: api/devices/list_device_providers.md
-  api-clients/devices/list-devices: api/devices/list.md
-  api-clients/devices/list-unmanaged-devices: api/devices/unmanaged/list.md
-  api-clients/devices/update-device: api/devices/update.md
-  api-clients/devices/update-unmanaged-device: api/devices/unmanaged/update.md
-  api-clients/events/get-an-event: api/events/get.md
-  api-clients/events/list-events: api/events/list.md
-  api-clients/locks/get-lock: api/locks/get.md
-  api-clients/locks/list-locks: api/locks/list.md
-  api-clients/locks/lock-a-lock: api/locks/lock_door.md
-  api-clients/locks/unlock-a-lock: api/locks/unlock_door.md
-  api-clients/noise-sensors/create-noise-threshold: api/noise_sensors/noise_thresholds/create.md
-  api-clients/noise-sensors/delete-noise-threshold: api/noise_sensors/noise_thresholds/delete.md
-  api-clients/noise-sensors/list-noise-thresholds: api/noise_sensors/noise_thresholds/list.md
-  api-clients/noise-sensors/update-noise-threshold: api/noise_sensors/noise_thresholds/update.md
-  api-clients/noise-sensors: api/noise_sensors/README.md
-  api-clients/thermostats/get-thermostat: api/thermostats/README.md
-  api-clients/thermostats/list-thermostats: api/thermostats/list.md
-  api-clients/thermostats/set-fan-mode: api/thermostats/set_fan_mode.md
-  api-clients/thermostats/set-to-cool-mode: api/thermostats/cool.md
-  api-clients/thermostats/set-to-heat-cool-auto-mode: api/thermostats/heat_cool.md
-  api-clients/thermostats/set-to-heat-mode: api/thermostats/heat.md
-  api-clients/thermostats/set-to-off-mode: api/thermostats/off.md
-  api-clients/user-identities/add-an-acs-user-to-a-user-identity: api/user_identities/add_acs_user.md
-  api-clients/user-identities/create-a-user-identity: api/user_identities/create.md
-  api-clients/user-identities/delete-a-user-identity: api/user_identities/delete.md
-  api-clients/user-identities/get-a-user-identity: api/user_identities/get.md
-  api-clients/user-identities/grant-a-user-identity-access-to-a-device: api/user_identities/grant_access_to_device.md
-  api-clients/user-identities/list-accessible-devices-for-a-user-identity: api/user_identities/list_accessible_devices.md
-  api-clients/user-identities/list-acs-systems-associated-with-a-user-identity: api/user_identities/list_acs_systems.md
-  api-clients/user-identities/list-acs-users-associated-with-a-user-identity: api/user_identities/list_acs_users.md
-  api-clients/user-identities/list-user-identities: api/user_identities/list.md
-  api-clients/user-identities/remove-an-acs-user-from-a-user-identity: api/user_identities/remove_acs_user.md
-  api-clients/user-identities/revoke-access-to-a-device-from-a-user-identity: api/user_identities/revoke_access_to_device.md
-  api-clients/user-identities: api/user_identities/README.md
-  api-clients/workspaces/get-workspace: api/workspaces/get.md
-  api-clients/workspaces/reset-workspace: api/workspaces/reset_sandbox.md
-  api-clients/phones/create-a-sandbox-phone: api/phones/simulate/create_sandbox_phone.md

codegen/validate-redirects.ts

@@ -69,7 +69,7 @@ for (const { configPath, root, redirects } of configs) {
         configPath,
         source,
         target,
-        reason: `Source belongs to the "${foreignSource}" section. Move this redirect to that section's .gitbook.yaml`,
+        reason: `Source belongs to the "${foreignSource}" section. Use a site-level redirect in the GitBook UI instead`,
       })
       continue
     }
@@ -80,7 +80,7 @@ for (const { configPath, root, redirects } of configs) {
         configPath,
         source,
         target,
-        reason: `Target points to the "${foreignTarget}" section. Move this redirect to that section's .gitbook.yaml`,
+        reason: `Target points to the "${foreignTarget}" section. Use a site-level redirect in the GitBook UI instead`,
       })
       continue
     }