Known Issues
Evidence basis: source-verified at the pinned commit. Claims on this page were checked by reading the CNA source at commit c1c316b9; unless a sentence says otherwise, nothing here was built or executed. Each entry states exactly what was read and what, if anything, was executed.
This area answers one question: what is wrong with, or missing from, CNA right now? It lists only what exists at CNA commit c1c316b9. A defect that has been fixed is not listed; a deliberate design choice is not called a bug; and a shortfall of this website's documentation is not a CNA defect.
Four kinds of issue
| Category | Entries | Definition |
|---|---|---|
| Bug | 191 | Existing behaviour violates an intended or documented contract. |
| Functional gap | 60 | Functionality is intentionally or currently incomplete or unsupported; nothing violates a contract, the contract is narrower than one might expect. |
| Platform limitation | 13 | A host, platform or toolchain constraint makes behaviour differ or be unavailable. |
| Verification gap | 46 | An implementation exists, but the evidence that it behaves correctly is insufficient. |
By subsystem
| Subsystem | Bugs | Gaps | Platform limits | Verification gaps | Total |
|---|---|---|---|---|---|
| Math & geometry | 24 | 0 | 0 | 2 | 26 |
| Core & runtime | 13 | 7 | 0 | 0 | 20 |
| Graphics & renderers | 25 | 22 | 7 | 1 | 55 |
| Content & XNB/CNB/CNJ | 14 | 2 | 0 | 0 | 16 |
| Models & glTF | 5 | 10 | 0 | 0 | 15 |
| Input | 6 | 1 | 1 | 0 | 8 |
| Audio & media | 15 | 4 | 0 | 2 | 21 |
| Storage | 6 | 2 | 1 | 0 | 9 |
| Networking & gamer services | 15 | 5 | 2 | 0 | 22 |
| Platforms | 4 | 3 | 2 | 3 | 12 |
| Build & CI | 12 | 1 | 0 | 4 | 17 |
| Testing & evidence | 3 | 0 | 0 | 30 | 33 |
| Diagnostics & Inspector | 5 | 2 | 0 | 2 | 9 |
| C API & bindings | 3 | 1 | 0 | 2 | 6 |
| Documentation & release tooling | 41 | 0 | 0 | 0 | 41 |
How an entry gets here
- Every entry was re-verified at the pinned commit. An earlier audit finding is a candidate, not a fact: it was checked against the source, headers, build files and tests at
c1c316b9. - Every entry was then read a second time by a reviewer whose brief was to refute it. A reviewer could confirm, correct, narrow, reclassify, fold or remove an entry; the candidates that were dismissed earlier were re-read by reviewers told to prove the dismissal wrong, and a sample of entries was also checked by running small probes built from the pinned sources.
- A finding is removed only on positive evidence: the fixing code and, where one exists, the test that pins it; the renderer registry that retires the affected family (its identity is refused at configure time); or the source and the XNA 4.0 or FNA reference showing that the behaviour is the documented contract. It is not removed because a TODO vanished or a subsystem was rewritten.
- Evidence is stated per entry. Source-verified means the failure follows from code that was read at the pinned commit; it is not a run. Reproduced means something was executed for the entry and the Evidence section names exactly what. Recorded by CNA means CNA’s own recorded run says so and it was not repeated here. Inferred means it follows from the code but depends on a platform or toolchain step nobody executed. Each entry also says whether any test touches the affected area.
- Documentation bugs are CNA’s. A comment, header or document inside the CNA repository that contradicts the code at that commit is recorded as a bug in the Documentation & release tooling subsystem; it says the text is stale, not that the code is wrong. A gap in this website is never listed.
- Stable identifiers.
CNA-BUG-###identifiers are kept from the earlier audits; new ones continue the sequence.
Machine-readable index
The same list is published as data/known-issues.json (identifier, category, subsystem, status, severity, evidence basis, source paths, detail page), pinned to c1c316b9.
Related
What each subsystem is supposed to do is on the Deep Dives and the Verification & Known Issues guide page; how to change it safely is in the Development area.