Skip to content

Commit 3219d0e

Browse files
authored
add a readme for the dart fix tests (flutter#73761)
add a readme for the dart fix tests
1 parent 678a4e8 commit 3219d0e

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

packages/flutter/test_fixes/README.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
## Directory contents
2+
3+
The Dart files and golden master `.expect` files in this directory are used to
4+
test the `dart fix` framework refactorings used by the Flutter framework.
5+
6+
<!-- TODO(devoncarew): Add link to public user guide when available. -->
7+
8+
See the flutter/packages/flutter/lib/fix_data.yaml file for the current package:flutter
9+
data driven fixes.
10+
11+
## When making structural changes to this directory
12+
13+
Note that the tests in this directory are also invoked from external repositories.
14+
Specifically, the CI system for the dart-lang/sdk repo runs these tests in order to
15+
ensure that changes to the dart fix file format do not break Flutter.
16+
17+
See [tools/bots/flutter/analyze_flutter_flutter.sh](https://github.com/dart-lang/sdk/blob/master/tools/bots/flutter/analyze_flutter_flutter.sh)
18+
for where the tests are invoked.
19+
20+
When possible, please coordinate changes to this directory that might affect the
21+
`analyze_flutter_flutter.sh` script.

0 commit comments

Comments
 (0)