Merge pull request #44 from davidmorgan/improve-readme
Describe places where pedantic is stricter than Effective Dart.
diff --git a/README.md b/README.md
index 6a64196..1ad45af 100644
@@ -11,10 +11,10 @@
- It contains occasional small snippets of Dart code that are used in
implementing those best practices.
-Note that everything here fits within the guidelines set out in
+Most of the recommended lints directly implement the guidelines set out in
-You could think of that document as the _design_ and this package as one
-possible partial _implementation_.
+In a few cases the lints are stricter than the style guide for the sake of
+consistency. Details [below](#stricter-than-effective-dart).
[this Medium article](https://medium.com/dartlang/pedantic-dart-1c7d365510de)
@@ -42,6 +42,24 @@
The currently enabled lints can be found in
+## Stricter than Effective Dart
+Here are the important places where `pedantic` is stricter than Effective Dart:
+`annotate_overrides` is stricter; Effective Dart says nothing about
+`omit_local_variable_types` is stricter; Effective Dart only says to
+type annotating initialized local variables.
+`prefer_single_quotes` is stricter; Effective Dart says nothing about
+single vs double quotes.
+`use_function_type_syntax` is stricter; Effective Dart only says to
+using the new syntax.
## Using the Lints
To use the lints add a dependency in your `pubspec.yaml`: