From 6cb8f0f09a55ea4755da46a3db43dea207c700bc Mon Sep 17 00:00:00 2001 From: me-valenzuela <58711366+me-valenzuela@users.noreply.github.com> Date: Fri, 4 Sep 2026 17:45:09 +0200 Subject: [PATCH 1/3] docs(reference): group Reference sidebar into logical categories Split the flat Reference menu into seven categories (Setup & Authentication, Hardware & Devices, Payments & Features, Transaction Recovery, Testing & Validation, Technical Reference, Troubleshooting). Sidebar-only change: no files moved, no doc URLs changed. Co-Authored-By: Claude Opus 4.8 --- sidebars.js | 96 ++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 66 insertions(+), 30 deletions(-) diff --git a/sidebars.js b/sidebars.js index 98538d6..edf7c50 100644 --- a/sidebars.js +++ b/sidebars.js @@ -62,19 +62,42 @@ const sidebars = { label: 'Reference', collapsible: false, items: [ - 'reference/android-sdk-setup', - 'reference/android-demo-app', - 'reference/android-integration-walkthrough', - 'reference/javascript-sdk-setup', - 'reference/windows-sdk-setup', - 'reference/authentication', - 'reference/development-hardware', - 'reference/manual-injection', - 'reference/pre-authorization-guide', - 'reference/multi-mid', - 'reference/avs-for-moto', - 'reference/fee-mitigation', - 'reference/partial-approval', + { + type: 'category', + label: 'Setup & Authentication', + items: [ + 'reference/authentication', + 'reference/android-sdk-setup', + 'reference/android-integration-walkthrough', + 'reference/android-demo-app', + 'reference/javascript-sdk-setup', + 'reference/windows-sdk-setup', + ], + }, + { + type: 'category', + label: 'Hardware & Devices', + items: [ + 'reference/development-hardware', + 'reference/devices', + 'reference/manual-injection', + 'reference/hilite-vs-pax', + ], + }, + { + type: 'category', + label: 'Payments & Features', + items: [ + 'reference/pre-authorization-guide', + 'reference/partial-approval', + 'reference/avs-for-moto', + 'reference/moto-guide', + 'reference/multi-mid', + 'reference/fee-mitigation', + 'reference/interac-void', + 'reference/terminal-reversals', + ], + }, { type: 'category', label: 'Transaction Recovery', @@ -87,24 +110,37 @@ const sidebars = { 'reference/transaction-recovery-windows-sdk', ], }, - 'reference/terminal-reversals', - 'reference/testing-edge-cases', - 'reference/devices', - 'reference/acquirer-capabilities-matrix', - 'reference/interac-void', - 'reference/transaction-result-object', - 'reference/error-codes', - 'reference/cordova-events', - 'reference/hilite-vs-pax', - 'reference/moto-guide', - 'reference/receipt-compliance', - 'reference/validate-integration', - 'reference/validate-integration-android-sdk', - 'reference/known-issues', { - type: 'link', - label: 'OpenAPI Specification', - href: '/openapi.yaml', + type: 'category', + label: 'Testing & Validation', + items: [ + 'reference/validate-integration', + 'reference/validate-integration-android-sdk', + 'reference/testing-edge-cases', + ], + }, + { + type: 'category', + label: 'Technical Reference', + items: [ + 'reference/transaction-result-object', + 'reference/error-codes', + 'reference/cordova-events', + 'reference/acquirer-capabilities-matrix', + 'reference/receipt-compliance', + { + type: 'link', + label: 'OpenAPI Specification', + href: '/openapi.yaml', + }, + ], + }, + { + type: 'category', + label: 'Troubleshooting', + items: [ + 'reference/known-issues', + ], }, ], }, From a66b66d2f9b5f42e0cacb2e09e4758d16c9894c5 Mon Sep 17 00:00:00 2001 From: me-valenzuela <58711366+me-valenzuela@users.noreply.github.com> Date: Fri, 4 Sep 2026 17:56:12 +0200 Subject: [PATCH 2/3] fix(sidebar): remove dead back-office/rest-api-no-reader reference The rest-api-no-reader.md doc was deleted in 2c7c0d9 but its sidebar entry stayed, breaking `docusaurus start` on docs-v2. Remove the orphaned reference so the site builds. Co-Authored-By: Claude Opus 4.8 --- sidebars.js | 1 - 1 file changed, 1 deletion(-) diff --git a/sidebars.js b/sidebars.js index edf7c50..1db36b7 100644 --- a/sidebars.js +++ b/sidebars.js @@ -46,7 +46,6 @@ const sidebars = { type: 'category', label: 'Back Office', items: [ - 'back-office/rest-api-no-reader', 'back-office/device-commands', 'back-office/transaction-feed-api', 'back-office/tms-apis', From e71832b53c2e6abd57faaea3105e05e32c5bff6d Mon Sep 17 00:00:00 2001 From: me-valenzuela <58711366+me-valenzuela@users.noreply.github.com> Date: Fri, 4 Sep 2026 18:04:24 +0200 Subject: [PATCH 3/3] docs(reference): order AVS for MOTO after MOTO Show the MOTO overview before the AVS-for-MOTO detail page, since AVS builds on the MOTO concept. Co-Authored-By: Claude Opus 4.8 --- sidebars.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sidebars.js b/sidebars.js index 1db36b7..69aeefe 100644 --- a/sidebars.js +++ b/sidebars.js @@ -89,8 +89,8 @@ const sidebars = { items: [ 'reference/pre-authorization-guide', 'reference/partial-approval', - 'reference/avs-for-moto', 'reference/moto-guide', + 'reference/avs-for-moto', 'reference/multi-mid', 'reference/fee-mitigation', 'reference/interac-void',