docs: restructure surface docs into landing + workflow + sub-components

README.md

@@ -54,17 +54,17 @@ See the [SDK Dev App README](sdk-app/README.md) for full setup and usage details
   - [Proxy Examples](docs/reference/proxy-examples.md)
 - [Workflows Overview](docs/workflows-overview/workflows-overview.md)
   - [Company Onboarding](docs/workflows-overview/company-onboarding.md)
-  - [Contractor Onboarding](docs/workflows-overview/contractor-onboarding.md)
-  - [Contractor Payments](docs/workflows-overview/contractor-payments.md)
-  - [Employee Onboarding](docs/workflows-overview/employee-onboarding/employee-onboarding.md)
-    - [Employee Self-Onboarding](docs/workflows-overview/employee-onboarding/employee-self-onboarding.md)
+  - [Contractor Onboarding](docs/workflows-overview/contractor-onboarding/contractor-onboarding.mdx)
+  - [Contractor Payments](docs/workflows-overview/contractor-payments/contractor-payments.mdx)
+  - [Employee Onboarding](docs/workflows-overview/employee-onboarding/employee-onboarding.mdx)
+    - [Employee Self-Onboarding](docs/workflows-overview/employee-self-onboarding/employee-self-onboarding.mdx)
   - [Employee Dashboard](docs/workflows-overview/employee-dashboard.md)
   - [Employee Termination](docs/workflows-overview/employee-termination.md)
   - [Information Requests](docs/workflows-overview/information-requests.md)
-  - [Run Payroll](docs/workflows-overview/run-payroll.md)
-  - [Off-Cycle Payroll (Bonus & Correction)](docs/workflows-overview/off-cycle-payroll.md)
-  - [Dismissal Payroll](docs/workflows-overview/dismissal-payroll.md)
-  - [Transition Payroll](docs/workflows-overview/transition-payroll.md)
+  - [Run Payroll](docs/workflows-overview/run-payroll/run-payroll.mdx)
+  - [Off-Cycle Payroll (Bonus & Correction)](docs/workflows-overview/off-cycle-payroll/off-cycle-payroll.mdx)
+  - [Dismissal Payroll](docs/workflows-overview/dismissal-payroll/dismissal-payroll.mdx)
+  - [Transition Payroll](docs/workflows-overview/transition-payroll/transition-payroll.mdx)
 - [Hooks (Experimental)](docs/hooks/hooks.md)
   - [useEmployeeDetailsForm](docs/hooks/useEmployeeDetailsForm.md)
   - [useCompensationForm](docs/hooks/useCompensationForm.md)

docs-site/docusaurus.config.ts

@@ -151,7 +151,7 @@ const config: Config = {
         {
           title: 'Build',
           items: [
-            { label: 'Workflows', to: '/docs/workflows-overview' },
+            { label: 'Workflows', to: '/docs/surfaces' },
             { label: 'Event Handling', to: '/docs/integration-guide/event-handling' },
             { label: 'Hooks', to: '/docs/hooks' },
           ],