move flutter user analysis options file (#8091)
* move flutter user analysis options file
* add comments referencing each of the analysis options files
diff --git a/.analysis_options b/.analysis_options
index 0f0e7a8..cd78af0 100644
--- a/.analysis_options
+++ b/.analysis_options
@@ -7,8 +7,13 @@
# See the configuration guide for more
# https://github.com/dart-lang/sdk/tree/master/pkg/analyzer#configuring-the-analyzer
#
+# There are three similar analysis options files in the flutter repo:
+# - .analysis_options (this file)
+# - .analysis_options_repo
+# - packages/flutter/lib/analysis_options_user.yaml
+#
# This file contains the analysis options used by Flutter editors, such as Atom.
-# It is very similar to .analysis_options_flutter_analyze;
+# It is very similar to the .analysis_options_repo file in this same directory;
# the only difference (currently) is the public_member_api_docs option,
# which triggers too many messages to be used in editors.
