From 3219d0e2ec2a5428179e15adf6f365820ce39ecd Mon Sep 17 00:00:00 2001 From: Devon Carew Date: Tue, 12 Jan 2021 15:13:23 -0800 Subject: [PATCH] add a readme for the dart fix tests (#73761) add a readme for the dart fix tests --- packages/flutter/test_fixes/README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 packages/flutter/test_fixes/README.md diff --git a/packages/flutter/test_fixes/README.md b/packages/flutter/test_fixes/README.md new file mode 100644 index 0000000000..33e90d0d96 --- /dev/null +++ b/packages/flutter/test_fixes/README.md @@ -0,0 +1,21 @@ +## Directory contents + +The Dart files and golden master `.expect` files in this directory are used to +test the `dart fix` framework refactorings used by the Flutter framework. + + + +See the flutter/packages/flutter/lib/fix_data.yaml file for the current package:flutter +data driven fixes. + +## When making structural changes to this directory + +Note that the tests in this directory are also invoked from external repositories. +Specifically, the CI system for the dart-lang/sdk repo runs these tests in order to +ensure that changes to the dart fix file format do not break Flutter. + +See [tools/bots/flutter/analyze_flutter_flutter.sh](https://github.com/dart-lang/sdk/blob/master/tools/bots/flutter/analyze_flutter_flutter.sh) +for where the tests are invoked. + +When possible, please coordinate changes to this directory that might affect the +`analyze_flutter_flutter.sh` script.