In the 5 August 2025 BCD meeting, we agreed that #27489 ought to ship. As part of that discussion, we agreed that there ought to be some sort of documentation covering that BCD exports TypeScript types and how to import them. This would demonstrate our commitment to treating TypeScript times as more than internal convenience (beyond the one line mentioning types in the SemVer policy).
I don't care strongly how types are documented, but my suggestion would be to append something to the code block demonstrating imports with something like:
// TypeScript types
import type { SimpleSupportStatement } from '@mdn/browser-compat-data';
In the 5 August 2025 BCD meeting, we agreed that #27489 ought to ship. As part of that discussion, we agreed that there ought to be some sort of documentation covering that BCD exports TypeScript types and how to import them. This would demonstrate our commitment to treating TypeScript times as more than internal convenience (beyond the one line mentioning types in the SemVer policy).
I don't care strongly how types are documented, but my suggestion would be to append something to the code block demonstrating imports with something like: