Merge pull request #70 from tnorbye/snapshot13

Update documentation snapshot

Author: tnorbye

docs/api-guide/basics.md.html

@@ -31,9 +31,9 @@
 
 ### API Stability
 
-Lint's APIs are still marked as @Beta, and we have made it very clear
-all along that this is not a stable API, so custom lint checks may need
-to be updated periodically to keep working.
+Lint's APIs are not stable, and a large part of Lint's API surface is
+not under our control (such as UAST and PSI). Therefore, custom lint
+checks may need to be updated periodically to keep working.
 
 However, ”some APIs are more stable than others“. In particular, the
 detector API (described below) is much less likely to change than the

docs/api-guide/changes.md.html

@@ -19,6 +19,15 @@
   annotations in source form (until now, this only worked if the files
   were provided as binary class files)
 
+* String replacement quickfixes can now be configured with a list of
+  imports to be performed when the fix is applied. This can be used to
+  for example import Kotlin extension functions needed by the
+  replacement string. (You should not use this for normal imports;
+  instead, the replacement string should use fully qualified names
+  everywhere along with the `shortenNames` property on the fix, and
+  then lint will rewrite and import all symbols that can be done
+  without conflicts.)
+
 **7.2**
 
 * There is now a way to register “options” for detectors. These are

docs/api-guide/quickfixes.md.html

@@ -129,6 +129,21 @@
     with simple names because there is a conflicting import of the same
     name from a different package.
 
+    Normally, you should write your replacement source code using fully
+    qualified names, and then apply `shortenNames` to the quickfix to
+    tell lint to replace fully qualified names with imports; don't try
+    to write your quickfix to also add the import statements on its
+    own. There's a possibility that a given name cannot be imported
+    because it's already importing the same name for a different
+    namespace. When using fully qualified names, lint will specifically
+    handle this.
+
+    In some cases you cannot use fully qualified names in the code
+    snippet; this is the case with Kotlin extension functions for
+    example. For that scenario, the replacement quickfix has an
+    `imports` property you can use to specify methods (and classes and
+    fields) to import at the same time.
+
 * `fix().annotate`: Annotating an element. This will add (or optionally
   replace) an annotation on a source element such as a method. It will
   also handle import management.

docs/checks/BadConfigurationProvider.md.html

@@ -17,11 +17,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.work.lint.workmanager)
+:   Android Open Source Project
 Identifier
-:   androidx.work.lint.workmanager
+:   androidx.work
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=409906
 Affects
 :   Kotlin and Java files
 Editing

docs/checks/BadPeriodicWorkRequestEnqueue.md.html

@@ -15,11 +15,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.work.lint.workmanager)
+:   Android Open Source Project
 Identifier
-:   androidx.work.lint.workmanager
+:   androidx.work
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=409906
 Affects
 :   Kotlin and Java files
 Editing

docs/checks/EnsureInitializerMetadata.md.html

@@ -17,11 +17,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.startup.lint.startupruntime)
+:   Android Open Source Project
 Identifier
-:   androidx.startup.lint.startupruntime
+:   androidx.startup
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=823348
 Affects
 :   Kotlin and Java files and manifest files
 Editing

docs/checks/EnsureInitializerNoArgConstr.md.html

@@ -17,11 +17,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.startup.lint.startupruntime)
+:   Android Open Source Project
 Identifier
-:   androidx.startup.lint.startupruntime
+:   androidx.startup
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=823348
 Affects
 :   Kotlin and Java files
 Editing

docs/checks/FragmentGradleConfiguration.md.html

@@ -15,11 +15,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.fragment.testing.lint.fragmenttesting)
+:   Android Open Source Project
 Identifier
-:   androidx.fragment.testing.lint.fragmenttesting
+:   androidx.fragment.testing
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=460964
 Affects
 :   Gradle build files
 Editing
@@ -68,7 +68,7 @@
 The above example was automatically extracted from the first unit test
 found for this lint check, `GradleConfigurationDetector.expectFail`.
 To report a problem with this extracted sample, visit
-https://issuetracker.google.com/issues/new?component=192731.
+https://issuetracker.google.com/issues/new?component=460964.
 
 (##) Suppressing
 

docs/checks/IdleBatteryChargingConstraints.md.html

@@ -15,11 +15,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.work.lint.workmanager)
+:   Android Open Source Project
 Identifier
-:   androidx.work.lint.workmanager
+:   androidx.work
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=409906
 Affects
 :   Kotlin and Java files
 Editing

docs/checks/InvalidPeriodicWorkRequestInterval.md.html

@@ -17,11 +17,11 @@
 Platform
 :   Android
 Vendor
-:   Android Open Source Project (androidx.work.lint.workmanager)
+:   Android Open Source Project
 Identifier
-:   androidx.work.lint.workmanager
+:   androidx.work
 Feedback
-:   https://issuetracker.google.com/issues/new?component=192731
+:   https://issuetracker.google.com/issues/new?component=409906
 Affects
 :   Kotlin and Java files
 Editing