Better docs at top level with categorized summary of classes and functions
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt
index 472cfd8..c6bfdc0 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt
@@ -57,9 +57,10 @@
val isCancelled: Boolean
/**
- * Awaits for completion of this value without blocking a thread and resumes when deferred computation is complete.
- * This suspending function is cancellable.
+ * Awaits for completion of this value without blocking a thread and resumes when deferred computation is complete,
+ * returning the resulting value or throwing the corresponding exception if the deferred had completed exceptionally.
*
+ * This suspending function is cancellable.
* If the [Job] of the current coroutine is completed while this suspending function is waiting, this function
* immediately resumes with [CancellationException].
*/