Currently, the Flutter framework uses snippet blocks in API reference docs to showcase example code. We are considering switching to Markdown code blocks.
To ensure these these examples don't "bit rot", we can use "code excerpts" to synchronize the examples to validated test files.