@@ -15,7 +15,7 @@ This page covers each (at a high level, as ***the feature is still in preview***
15
15
in the following sections:
16
16
17
17
- [ ** The ` JsonCodable ` macro** ] ( #the-jsoncodable-macro ) :
18
- A ready-made macro you can try out today (behind an experiment flag)
18
+ A ready-made macro you can try out today (behind an experimental flag)
19
19
that offers a seamless solution to the
20
20
common issue of tedious JSON serialization and deserialization in Dart.
21
21
@@ -31,7 +31,7 @@ the feature is complete.
31
31
## The ` JsonCodable ` macro
32
32
33
33
::: important
34
- The ` JsonCodable ` macro is not stable and currently behind an [ experiment flag] [ ] .
34
+ The ` JsonCodable ` macro is not stable and currently behind an [ experimental flag] [ ] .
35
35
It only works with Dart ` 3.5.0-152 ` or later.
36
36
This is available from the [ Dart dev channel] [ channel ]
37
37
or from the [ Flutter master channel] [ flutter-channel ] .
@@ -44,7 +44,7 @@ user-defined Dart classes to JSON maps of type `Map<String, Object?>`.
44
44
It generates two members, a ` toJson ` serialization method,
45
45
and a ` fromJson ` deserialization constructor.
46
46
47
- [ experiment flag] : /tools/experiment-flags
47
+ [ experimental flag] : /tools/experiment-flags
48
48
[ `JsonCodable` ] : {{site.pub-pkg}}/json/versions/0.20.0
49
49
[ channel ] : https://dart.dev/get-dart#release-channels
50
50
[ flutter-channel ] : {{site.flutter-docs}}/release/upgrade#other-channels
@@ -75,7 +75,7 @@ and a `fromJson` deserialization constructor.
75
75
import 'package:json/json.dart';
76
76
```
77
77
78
- 7 . Run your project with the experiment flag:
78
+ 7 . Run your project with the experimental flag:
79
79
80
80
``` console
81
81
dart run --enable-experiment=macros bin/my_app.dart
@@ -233,8 +233,9 @@ Some common examples that we hope to solve with macros in the future are:
233
233
### How macros work
234
234
235
235
::: important
236
- The macros language feature is not stable and currently behind an [ experiment flag] [ ] .
237
- Functionality is highly subject to change. This section will remain very high-level until stable.
236
+ The macros language feature is not stable and currently behind an
237
+ [ experimental flag] [ ] . Functionality is highly subject to change.
238
+ This section will remain very high-level until stable.
238
239
:::
239
240
240
241
To create a macro, you write a macro declaration similar to a class,
@@ -275,7 +276,7 @@ properties. The macro gathers this information through deep [introspection][] of
275
276
the program.
276
277
277
278
Macros are still under development, so that's as much detail we can go into for now.
278
- If you're curious, or would like to try it yourself behind an experiment flag,
279
+ If you're curious, or would like to try it yourself behind an experimental flag,
279
280
the best guidance is to take a look at the implementation of exisiting macros:
280
281
281
282
- Check out the [ definition] [ json ] of the ` JsonCodable ` macro,
0 commit comments