Bulk-delete orphaned/superseded pages across en/api, en/automation, en/service (#281) - #288
Merged
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
digitaldiina
added
mintlify/content-parity
added 13 commits
August 18, 2026 11:18
…docs (#281) Superseded conceptual API pages with no active replacement in the Mintlify content tree; the equivalent content still lives in the frozen superoffice-docs repo.
21 of 24 pages were already unwired from nav; repoints the existing /en/diary/tutorials/* redirect directly at the superoffice-docs destination rather than leaving it chained through the deleted path. Media exclusively used by these pages is removed; images shared with surviving pages (quote-connectors, erp-connectors, bulk-operations, archive-providers) are kept.
…ice-docs (#281) Only the 9 Deep Dive conceptual pages (architecture, interfaces, data-classes, scenarios, metadata, providers, extenders, joiners, base-and-helper-classes) - the rest of archive-providers/, including its generated reference/ subtree, is untouched. No live cross-references existed outside the deleted files themselves.
Repoints the existing /en/authentication/onsite/* redirect directly at the superoffice-docs destination rather than leaving it chained through the deleted path.
…-docs (#281) Kept as 3 separate redirects rather than one shared wildcard - the sibling en/api/reference/restful tree survives, so no common parent can be safely wildcarded. Zero nav-en.json wiring existed for any of these three trees; the real risk here was the in-content cross-references from other languages' sale/document/project/request pages and the developer-portal, all fixed. The many <a href="/en/api/reference/soap/ Services88/..."> and .../customer-service/... links across all 6 languages needed no change - they already resolve through 2 pre-existing, more-specific redirect entries unrelated to this deletion (Services88/* -> wsdl.zip, customer-service/* -> the REST WebAPI endpoint page), not through a real file in this tree. Left untouched, pre-existing and unrelated to this deletion: one already-broken link in en/automation/crmscript/howto/document/ templates.mdx pointing at a .yml file that never existed in the Mintlify content tree.
Clean, isolated deletion - zero nav wiring, zero cross-references.
Clean, isolated deletion - zero nav wiring, zero cross-references.
…content (#281) Direct instruction: don't link users out of the site to outdated raw markdown/code samples in the frozen superoffice-docs repo, especially in Guides-tab/user-guide content. Removes the bullet/list-item/reference in every rows/sql/osql/caching-adjacent, tutorials-adjacent, document-plugin, and automation/windows cross-reference fixed in earlier commits, across all 6 languages where the structure repeats identically. The redirects themselves are untouched - only in-content links are cut. Kept as-is: en/onsite/batch-task-server.mdx and en/onsite/integrate/web-client/index.md (onsite/admin-facing technical docs, not user guide content), plus the unrelated caching links in en/admin/user-preferences, en/company/dev, en/contact/dev, en/customization/web-panels/dev (not part of this instruction).
digitaldiina
force-pushed
the
281-bulk-delete
branch
from
August 18, 2026 09:21
595e7a3 to
dbd309a
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Largest of the 5 #182-follow-up issues (the other 4 - #277, #278, #279, #280 - are done). 12 commits, one complete/reviewable fix per topic group, each deleting content, updating
config/nav-en.jsonwhere wired, adding single-hop redirect(s) to the matching path in the frozensuperoffice-docsrepo, and fixing every in-repo cross-reference found (all 6 languages where applicable):en/api/{rows,sql,osql}- 83 files, heaviest cross-reference load (company/contact/diary/project/sale index+dev pages across all 6 languages), 3 folder wildcards, repoints 16 existing redirects that chained through these paths.en/api/caching- 7 files, 1 wildcard.en/api/web-extensions- 11 files (incl. deadtoc.yml), 1 wildcard.en/api/tutorials- 24 files (21 already unwired from nav), 1 wildcard, repoints the existing/en/diary/tutorials/*redirect off its now-dead chain target. Media: kept the 18 images shared with surviving pages (quote-connectors, erp-connectors, bulk-operations), deleted the other 68.en/api/archive-providersDeep Dive pages only (9 files: architecture, interfaces, data-classes, scenarios, metadata, providers, extenders, joiners, base-and-helper-classes) - the rest ofarchive-providers/, including its generatedreference/subtree, is untouched. 9 individual file redirects (not a folder wildcard, since the folder isn't wholly vacated).en/api/lists/{entity,row,sql}-lists/index.mdxandlists/services/stay. 3 folder wildcards (each subfolder is fully vacated even though the parent isn't), removes 2 dead self-contained redirects.en/api/authentication/onsite- repoints the existing/en/authentication/onsite/*redirect off its dead chain target.en/api/reference/{netserver,web,soap}- kept as 3 separate redirects, not one wildcard, since siblingreference/restfulsurvives. Zero nav wiring existed for any of the three; the real risk was cross-references from other languages' sale/document/project/request pages and the developer portal. The manysoap/Services88/*andsoap/customer-service/*links across all 6 languages needed no change - they already resolve through 2 pre-existing, more specific redirects unrelated to this deletion.en/api/tooltip- 3 files, zero nav/cross-refs/redirects, clean deletion.en/service/data-exchange- 2 files, same clean shape as tooltip.en/api/plugins/{document,sentry}- fixes the "SO_Arc document plugin" link on all 6 languages'document/index.mdx.en/automation/windows- single file, removes a now-dead specific redirect superseded by the new wildcard.Explicitly out of scope, confirmed untouched:
en/api/archive-providers/reference/,en/api/mdo-providers/reference/,en/database/tables/,en/automation/crmscript/(all generated content, tracked under #149/#183).Closes #281.
Test plan
tools/verify-nav-paths.py: 725 -> 619 checked pages, matching the sum of pages removed across all 12 commits (verified per-commit against baseline as each landed).mint validate(CI=true) - same single pre-existing warning as unmodifiedmain(components/so-form.jsximport), no new errors.Services88/*/customer-service/*redirect-dependent links, the 18 shared tutorials media references, and one pre-existing (unrelated) broken link in a CRMScript sample pointing at a.ymlthat never existed in this repo.markdownlint-cli2clean on every touched file.Note for reviewers
This branch and #277/#278 were all cut from
mainbefore any of them merged, and all three touchconfig/nav-en.json/config/redirects.json. Land in order #277 -> #278 -> #281 and expect to rebase this branch (mechanical conflict resolution on those two files, not a content redo) after each of the first two merges.