We've got docs now for android resources (woohoo!), and I think it'd be great to do the same for Java.

https://chromium.googlesource.com/chromium/src/+/HEAD/build/android/docs/README.md

Questions to answer:
* What does enable_incremental_javac do?
* What are .interface.jar files?
* What is desugaring and when does it happen?
* What do our bytecode rewriters do?
* When do you need direct deps vs indirect deps?
* How is classes.dex created in debug vs release?
* What do supports_android vs requires_android do? (enables dexing, android.jar in path)
* What is BuildHooks.java?
* Multidex considerations: How is main dex list created?
* What is errorprone?
* How does apk_under_test work?
 

We've got docs now for android resources (woohoo!), and I think it'd be great to do the same for Java.

https://chromium.googlesource.com/chromium/src/+/HEAD/build/android/docs/README.md

Questions to answer:
* What does enable_incremental_javac do?
* What are .interface.jar files?
* What is desugaring and when does it happen?
* What do our bytecode rewriters do?
* When do you need direct deps vs indirect deps?
* How is classes.dex created in debug vs release?
* What do supports_android vs requires_android do? (enables dexing, android.jar in path)
* What is BuildHooks.java?
* Multidex considerations: How is main dex list created?
* What is errorprone?
  * When to use it vs. checkstyle (Maybe add README.md to directories to spell this out as well)
* How does apk_under_test work?
 

We've got docs now for android resources (woohoo!), and I think it'd be great to do the same for Java.

https://chromium.googlesource.com/chromium/src/+/HEAD/build/android/docs/README.md

Questions to answer:
* What does enable_incremental_javac do?
* What are .interface.jar files?
* What is desugaring and when does it happen?
* What do our bytecode rewriters do?
* When do you need direct deps vs indirect deps?
* How is classes.dex created in debug vs release?
* What do supports_android vs requires_android do? (enables dexing, android.jar in path)
* What is BuildHooks.java?
* Multidex considerations: How is main dex list created?
* What is errorprone?
  * When to use it vs. checkstyle (Maybe add README.md to directories to spell this out as well)
* How does apk_under_test work?
* What are .srcjars / srcjar_deps?
  * Refer to  bug 693098