Minor documentation improvements

Author: qwwdfsad

kotlinx-coroutines-core/common/src/CoroutineScope.kt

@@ -73,14 +73,13 @@ public operator fun CoroutineScope.plus(context: CoroutineContext): CoroutineSco
  * Example of use:
  * ```
  * class MyAndroidActivity {
- *   private val scope = MainScope()
+ *     private val scope = MainScope()
  *
- *   override fun onDestroy() {
- *     super.onDestroy()
- *     scope.cancel()
- *   }
+ *     override fun onDestroy() {
+ *         super.onDestroy()
+ *         scope.cancel()
+ *     }
  * }
- *
  * ```
  *
  * The resulting scope has [SupervisorJob] and [Dispatchers.Main] context elements.
@@ -128,7 +127,6 @@ public val CoroutineScope.isActive: Boolean
  *         send(Math.sqrt(number))
  *     }
  * }
- *
  * ```
  */
 public object GlobalScope : CoroutineScope {
@@ -151,16 +149,15 @@ public object GlobalScope : CoroutineScope {
  *
  * ```
  * suspend fun showSomeData() = coroutineScope {
- *
- *   val data = async(Dispatchers.IO) { // <- extension on current scope
+ *     val data = async(Dispatchers.IO) { // <- extension on current scope
  *      ... load some UI data for the Main thread ...
- *   }
+ *     }
  *
- *   withContext(Dispatchers.Main) {
- *     doSomeWork()
- *     val result = data.await()
- *     display(result)
- *   }
+ *     withContext(Dispatchers.Main) {
+ *         doSomeWork()
+ *         val result = data.await()
+ *         display(result)
+ *     }
  * }
  * ```
  *

kotlinx-coroutines-core/common/src/flow/Builders.kt

@@ -291,6 +291,9 @@ public fun <T> channelFlow(@BuilderInference block: suspend ProducerScope<T>.()
  *     awaitClose { api.unregister(callback) }
  * }
  * ```
+ *
+ * This function is an alias for [channelFlow], it has a separate name to reflect
+ * the intent of the usage (integration with a callback-based API) better.
  */
 @Suppress("NOTHING_TO_INLINE")
 @ExperimentalCoroutinesApi

kotlinx-coroutines-debug/README.md

@@ -136,7 +136,7 @@ Do not use this module in production environment and do not rely on the format o
 
 Unfortunately, Android runtime does not support Instrument API necessary for `kotlinx-coroutines-debug` to function, triggering `java.lang.NoClassDefFoundError: Failed resolution of: Ljava/lang/management/ManagementFactory;`.
 
-Nevertheless, it will be possible to support debug agent on Android as soon as [GradleAspectJ-Android](https://github.com/Archinamon/android-gradle-aspectj)  will support androin-gradle 3.3 
+Nevertheless, it will be possible to support debug agent on Android as soon as [GradleAspectJ-Android](https://github.com/Archinamon/android-gradle-aspectj)  will support android-gradle 3.3 
 
 <!---
 Make an exception googlable