Tracking issue for a new Azure DevOps work item: fix the archive-providers/mdo-providers reference generator's known formatting defects at the source, and have it emit Mintlify MDX directly.
Current output: en/api/archive-providers/reference/ (373 files) and en/api/mdo-providers/reference/ (422 files), both .md, generated: true + envir: onsite, online frontmatter. Known defects were found and categorized while fixing Mintlify build errors on the documentation side — see #122 for the full breakdown — and are currently client-side patched by tools/fix-archive-providers-mdx.ps1 in this repo.
Acceptance criteria
Parallel generation
Files and locations
Known generator defects — fixed at the source, not patched after the fact
Frontmatter
Legacy navigation
Validation and testing
Cleanup tasks
Tracking issue for a new Azure DevOps work item: fix the archive-providers/mdo-providers reference generator's known formatting defects at the source, and have it emit Mintlify MDX directly.
Current output:
en/api/archive-providers/reference/(373 files) anden/api/mdo-providers/reference/(422 files), both.md,generated: true+envir: onsite, onlinefrontmatter. Known defects were found and categorized while fixing Mintlify build errors on the documentation side — see #122 for the full breakdown — and are currently client-side patched bytools/fix-archive-providers-mdx.ps1in this repo.Acceptance criteria
Parallel generation
superoffice-docsis not overwritten, removed, renamed, or redirected.Files and locations
en/api/archive-providers/reference/.en/api/mdo-providers/reference/..mdxextension.config/nav-archive-providers.json/config/nav-mdo-providers.jsoncontinue to be generated as flat JSON arrays of page paths, index first, with corrected/consistent casing.Known generator defects — fixed at the source, not patched after the fact
</p>after the "See also" line at end-of-file is no longer produced (357 instances, archive-providers).|on the## Supported Columnstable header row is always present (358 instances / 248 files, archive-providers).(in column-description cells is handled wherever it occurs in the string, not just at the edges.Frontmatter
title,description,generated: true,content_type: reference,envir.Legacy navigation
toc.ymlfor this content.docs.jsondirectly — the nav files above are consumed via$ref, same as today.Validation and testing
Cleanup tasks
tools/fix-archive-providers-mdx.ps1(including its hardcoded lookup table) from this repo.config/nav-mdo-providers.json.