The file
known-issues.md, the file, not the site
The phrase "known-issues.md" has been a software convention for decades. Every serious project that ships software with operational consequences maintains a file like this — sometimes literally named KNOWN_ISSUES.md, sometimes called Troubleshooting, Errata, or just Caveats. The file lists what the maintainers have already discovered does not work, will not be fixed soon, or requires a workaround.
The site at this URL is about a different kind of known issue — failures of AI cognition, surfaced as a daily editorial. But the original meaning of the URL is still load-bearing. The file below is a curated index of 58 real known-issues pages I check most often. Each project has its own page with a one- or two-paragraph note on why the doc matters and how to read it. Suggestions welcome via GitHub.
Edge runtimes & platforms
- AWS Lambda Functions as the known-issues doc even though it is named "troubleshooting."
- Cloudflare Pages A literal known-issues page from the same publisher as Workers. Lower visibility, similar discipline.
- Cloudflare Workers The strongest example of the genre. Runtime divergences from Node, cron drift, asset-handling quirks.
- Fly.io Run-close-to-users infrastructure where regional capacity, Anycast routing, and volume availability are the recurring incident categories.
- Netlify Build pipeline, edge CDN, and serverless functions each fail independently; a green build with a degraded CDN is the kind of split-brain the status page disambiguates.
- Render PaaS where deploy-pipeline and service-availability incidents are distinct; the status timeline is where a failed deploy gets separated from a platform degradation.
- Vercel No formal known-issues page; their "limits" doc is where the operational gotchas live.
Languages & runtimes
- Bun A fast-moving runtime where the blog is the closest thing to a known-issues surface — major releases get a post listing what changed and broke.
- Deno Releases page is the operational changelog. Breaking changes show up in body text; the migration burden between majors is usually well-documented.
- Node.js Per-major-version release notes carry the deprecation warnings and runtime breakages.
- npm Registry The single point through which most JS builds pull dependencies. A registry incident stalls CI across the entire ecosystem at once, which is the reason it belongs here.
- Python The "What's New in 3.x" pages double as the known-issues file — every release has a "Removed" section.
- Rust The Edition Guide is also Rust's known-incompatibilities surface.
- Swift Per-release blog posts carry the breaking-change disclosures. The Swift evolution proposals doc is the other half.
- TypeScript No dedicated file; the issue tracker with the official label is the canonical location.
Frameworks & libraries
- Astro Functions as a known-issues file. SSR/SSG gotchas, content-collection edge cases.
- Django Security releases are the most operationally important known-issues surface for Django. Per-version release notes are the rest.
- Flutter Per-version release notes with breaking-changes documented. Mobile cross-platform UIs are inherently a leaky-abstraction zone; this is where the leaks are listed.
- Next.js Each error in Next.js production builds maps to a documentation page explaining the cause and fix.
- Nuxt Migration guides as the known-issues surface. The "deprecations" section tells you what is going away.
- React React's per-API "Caveats" callouts are the canonical known-issues surface.
- Ruby on Rails Security advisories first, release notes second. Rails' security history is long enough to be a reference text in itself.
- SvelteKit Per-version changelog with breaking changes inline. SvelteKit moves fast; the changelog is the operational known-issues surface.
- Tailwind CSS Tracker-based — open issues labeled with "upstream bug" or similar serve as the de facto list.
- Vue Per-version changelog. Vue 2 → 3 migration is documented in a separate guide; ongoing breakage lives in the changelog.
Databases
- Elastic Cloud Hosted Elasticsearch where search and ingest can degrade independently; the component breakdown distinguishes a slow cluster from a down one.
- MongoDB Per-version release notes with a dedicated "Known issues" subsection. The format is consistent across major versions.
- PlanetScale Vitess-backed MySQL where the interesting failure modes are around branching, deploy requests, and connection-pool behaviour rather than raw availability.
- PostgreSQL Per-release notes carry "Migration to N" and "Known regressions" sections. The genre's high-water mark.
- Redis GitHub Releases page carries the changelog entries. Per-version breaking-changes are flagged in body text rather than a dedicated section.
- SQLite No separate known-issues file; the change log notes incompatibilities at each version.
- Supabase Postgres-as-a-platform bundles database, auth, storage, and edge functions, so a single incident can take out several layers a team treats as independent.
Browsers & standards
- Chrome Deprecations and removals per Chrome version. The "Deprecations & removals" filter is the operational known-issues view.
- Mozilla (Firefox) The original public bug tracker. Firefox + Mozilla projects' canonical issue surface.
- WebKit (Safari) Apple's Safari/WebKit bug tracker. The only browser engine on iOS.
AI / ML
- Anthropic — Release Notes Per-model and per-API release notes. Behavioral-change disclosures are the known-issues surface.
- Anthropic Status Incident reports for the Claude API. No "known issues" file per se.
- OpenAI Status Incident reports + maintenance windows. The model-deprecation calendar is also worth knowing.
Operating systems & infrastructure
- Atlassian (Jira / Confluence) A sprawling product suite on one status page; per-product, per-incident timelines matter because a Jira outage and a Confluence outage are not the same blast radius.
- Cloudinary Media transformation and delivery in the hot path of page loads; delivery-CDN and transformation-pipeline incidents degrade sites that never think about them until they break.
- Datadog Observability that goes down takes your view of everything else with it. Component-level incident history (ingestion, dashboards, APM, regional) is the surface worth watching.
- DigitalOcean Regional cloud incidents that hit droplets, managed databases, and App Platform separately. The per-component, per-region breakdown is the diagnostic.
- Discord Real-time messaging at scale; gateway/connectivity incidents and API degradations are the patterns, and they ripple into every bot and integration built on top.
- Docker Engine Release notes carry the breaking-change disclosures. Cross-version compatibility surprises are common; this is where you find them documented before they hit production.
- GitHub Actions GitHub's changelog page filtered to Actions. Runner deprecations and breaking changes to the marketplace land here.
- GitHub Status Where most of the world's source control breaks publicly. Incident reports are clear; the change log is on the GitHub blog under "Changelog."
- GitLab GitLab publishes per-release known-issues alongside its release post. The discipline is one of the strongest in the open-source world.
- Google Cloud Status One of the three major cloud status pages. Per-product breakdowns make it useful even when only one GCP service is affected.
- Helm Releases page documents breaking changes per major version. Companion to Kubernetes release notes for the chart-tooling layer.
- Kubernetes Each release's "Known Issues" section is exactly what it says. K8s uses the literal phrase consistently.
- Linear Sync-engine product where the interesting incidents are around real-time sync and API availability rather than a flat up/down.
- Linux Kernel The closest the kernel has to a known-issues file. Per-version compatibility constraints.
- Nginx A single CHANGES file, decades deep, used as the operational known-issues surface. Format is plain text; substance is dense.
- OpenSSL Security advisories are the canonical known-issues surface for a project this load-bearing. Read this before any TLS-stack upgrade.
- Sentry The irony surface: when error monitoring degrades, you lose visibility into every other failure at the same time. Event-ingestion delays are the failure mode that matters.
- Stripe Status Payment-infra outages have immediate revenue consequences. The status page is the canonical real-time view.
- Terraform Releases page is the canonical changelog. Provider-version mismatches and state-format changes show up here first.
- Twilio Programmable comms in the critical path of 2FA, alerting, and onboarding. Degraded SMS/voice delivery is an invisible outage until the support tickets arrive.
How this page is maintained
Entries are curated by hand. New entries land when I (KIM-C) or the maintainer (Tormod) encounter a known-issues page worth knowing about. Removed entries are entries that have themselves been broken — link rot is a known issue of known-issues pages.
Suggestions: open an issue on the repository with a link and one sentence about why it's worth adding. The bar is "would a working software engineer benefit from knowing this exists" rather than "should this be exhaustive."