Move some tables from top-level to package-level API references

Author: globsterg

kotlinx-coroutines-core/README.md

@@ -53,6 +53,22 @@ helper function.
 The [NonCancellable] job object is provided to suppress cancellation inside the
 `withContext(NonCancellable) {...}` block of code.
 
+# Package kotlinx.coroutines
+
+General-purpose coroutine builders, contexts, and helper functions.
+
+# Package kotlinx.coroutines.sync
+
+Synchronization primitives (mutex and semaphore).
+
+# Package kotlinx.coroutines.channels
+
+Channels — non-blocking primitives for communicating a stream of elements between coroutines.
+
+# Package kotlinx.coroutines.flow
+
+Flow — asynchronous cold and hot streams of elements.
+
 Ways to construct asynchronous streams of values:
 
 | **Name**                                                              | **Type** | **Description**
@@ -69,7 +85,9 @@ Ways to construct asynchronous streams of values:
 A *cold* stream is some process of generating values, and this process is performed separately for each subscriber.
 A *hot* stream uses the same source of values independently of whether there are subscribers.
 
-A [select][kotlinx.coroutines.selects.select] expression waits for the result of multiple suspending functions simultaneously:
+# Package kotlinx.coroutines.selects
+
+[Select][kotlinx.coroutines.selects.select] — expressions that perform multiple suspending operations simultaneously until one of them succeeds.
 
 | **Receiver**                                                 | **Suspending function**                                         | **Select clause**                                                 | **Non-suspending version**
 | ------------------------------------------------------------ | --------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------
@@ -80,26 +98,6 @@ A [select][kotlinx.coroutines.selects.select] expression waits for the result of
 | [ReceiveChannel][kotlinx.coroutines.channels.ReceiveChannel] | [receiveCatching][kotlinx.coroutines.channels.receiveCatching]  | [onReceiveCatching][kotlinx.coroutines.channels.onReceiveCatching] | [tryReceive][kotlinx.coroutines.channels.ReceiveChannel.tryReceive]
 | none                                                         | [delay][kotlinx.coroutines.delay]                               | [onTimeout][kotlinx.coroutines.selects.SelectBuilder.onTimeout]   | none
 
-# Package kotlinx.coroutines
-
-General-purpose coroutine builders, contexts, and helper functions.
-
-# Package kotlinx.coroutines.sync
-
-Synchronization primitives (mutex and semaphore).
-
-# Package kotlinx.coroutines.channels
-
-Channels — non-blocking primitives for communicating a stream of elements between coroutines.
-
-# Package kotlinx.coroutines.flow
-
-Flow — asynchronous cold and hot streams of elements.
-
-# Package kotlinx.coroutines.selects
-
-Select — expressions that perform multiple suspending operations simultaneously until one of them succeeds.
-
 # Package kotlinx.coroutines.intrinsics
 
 Low-level primitives for finer-grained control of coroutines.