Skip to content

PEP-1626: Remove dead knowledge.codat.io links from OAS specs - #1846

Closed
pmckinney-codat wants to merge 1 commit into
mainfrom
PEP-1626/remove-knowledge-codat-io-oas-links
Closed

PEP-1626: Remove dead knowledge.codat.io links from OAS specs#1846
pmckinney-codat wants to merge 1 commit into
mainfrom
PEP-1626/remove-knowledge-codat-io-oas-links

Conversation

@pmckinney-codat

Copy link
Copy Markdown
Collaborator

What

Removes all 32 dead knowledge.codat.io (Data Coverage Explorer) links from the bundled OAS specs:

  • static/oas/Codat-Sync-Payables-v1.json — 27
  • static/oas/Codat-Bank-Feeds-v2.json — 4 (3 markdown + 1 HTML <a> blockquote)
  • static/oas/Codat-Sync-Payables.json — 1

These render as dead links in the API-reference docs. knowledge.codat.io is being hard-torn-down with no redirect (PEP-1621 / PEP-1625; de-listed from public docs since April 2025), so the sentences are removed rather than repointed.

Why this is a stopgap

These specs are generated — Azure Pipelines in codat-internal/oas bundles and republishes them into this repo on every merge to main (tools/publish-oas-to-docs-repo.sh). This edit clears the live docs now but will be overwritten on the next spec drop. The durable upstream fix is tracked in PEP-1641 (remove the sentences from the codat-internal/oas source).

Notes

  • JSON re-validated after the edits; surrounding prose joins cleanly (paragraph breaks preserved).
  • Historical blog posts referencing the explorer are intentionally left as-is as a historical record.

Ticket: https://codatdocs.atlassian.net/browse/PEP-1626

🤖 Generated with Claude Code

knowledge.codat.io (the Data Coverage Explorer) is being hard-torn-down
with no redirect, so its coverage-explorer links are now dead. Remove all
32 references from the bundled OAS specs so the live API-reference docs
stop pointing at the dead host:

- Codat-Sync-Payables-v1.json (27), Codat-Bank-Feeds-v2.json (4),
  Codat-Sync-Payables.json (1)

These specs are generated from codat-internal/oas and republished on every
merge, so this is a stopgap; the durable upstream fix is tracked in PEP-1641.
Historical blog posts referencing the explorer are intentionally left as-is.

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

vercel Bot commented Jun 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
codat-docs Ready Ready Preview, Comment Jun 4, 2026 5:42pm

Request Review

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

Link check results for preview deployment (https://codat-docs-git-PEP-1626-remove-knowledge-codat-io-oas-links-codat.vercel.app):

[]

@pmckinney-codat
pmckinney-codat enabled auto-merge June 4, 2026 17:43
auto-merge was automatically disabled June 5, 2026 09:27

Pull request was closed

@pmckinney-codat
pmckinney-codat deleted the PEP-1626/remove-knowledge-codat-io-oas-links branch June 5, 2026 09:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant