Skip to content

Commit a8b9b1d

Browse files
Add "Asynchronous" term to glossary (#7100)
feat(glossary): Add "Asynchronous" entry with Dart-specific context - Added comprehensive entry explaining Dart's event loop model, Futures, async/await, Streams, and isolates - Short description optimized for site-wide hover tooltips - Related links to official Dart async programming docs - Labels for filtering: async, futures, event-loop, concurrency Enables better developer onboarding by defining core Dart concurrency concepts in the shared glossary system. Contributes to #6461 --------- Co-authored-by: Parker Lougheed <parlough@gmail.com>
1 parent 35d1600 commit a8b9b1d

File tree

2 files changed

+46
-1
lines changed

2 files changed

+46
-1
lines changed

site/lib/src/style_hash.dart

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22
// dart format off
33

44
/// The generated hash of the `main.css` file.
5-
const generatedStylesHash = 'RHmO6DK8CuPj';
5+
const generatedStylesHash = '';

src/data/glossary.yml

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,51 @@
5050
alternate:
5151
- "Quick assist"
5252

53+
- term: "Asynchronous"
54+
short_description: |-
55+
Programming paradigm in Dart where operations like
56+
I/O or network calls complete later without blocking the event loop.
57+
long_description: |-
58+
Dart uses a single-threaded event loop model for asynchronous programming,
59+
allowing non-blocking execution of time-consuming tasks such as
60+
file I/O, HTTP requests, and timers.
61+
Unlike synchronous code that blocks until completion,
62+
async operations queue through microtasks/events, keeping UIs responsive.
63+
64+
Key components include:
65+
66+
- **Futures**:
67+
Represent a value available later, created by APIs like `http.get()`.
68+
- **async/await**:
69+
Dart keywords for writing maintainable and readable asynchronous code.
70+
- **Streams**:
71+
Handle sequences of async events like data from web sockets.
72+
- **Isolates**:
73+
Enable true parallelism through
74+
independent execution contexts with message passing.
75+
related_links:
76+
- text: "Asynchronous programming: futures, async, await"
77+
link: "/libraries/async/async-await"
78+
type: "doc"
79+
- text: "Asynchronous programming overview"
80+
link: "/language/async"
81+
type: "doc"
82+
- text: "dart:async library"
83+
link: "https://api.dart.dev/dart-async"
84+
type: "api"
85+
- text: "Future class reference"
86+
link: "https://api.dart.dev/dart-async/Future-class.html"
87+
type: "api"
88+
labels:
89+
- "async"
90+
- "futures"
91+
- "event-loop"
92+
- "concurrency"
93+
alternate:
94+
- "Async"
95+
- "Non-blocking"
96+
97+
5398
- term: "Bottom type"
5499
short_description: |-
55100
A type that has no values and is a subtype of all other types.

0 commit comments

Comments
 (0)