Merge branch 'rr/yole/module-md-rewrite'

libraries/stdlib/src/Module.md

@@ -1,22 +1,65 @@
-Kotlin standard library is a set of functions and types implementing idiomatic patterns when working with collections,
+# Module stdlib
+
+## Kotlin Standard Library
+
+The Kotlin standard library is a set of functions and types implementing idiomatic patterns when working with collections,
 text and files.
 
-$kotlin: Core functions and types, available on all supported platforms,
+# Package kotlin
 
-$kotlin.browser: API to access the web browser DOM
+Core functions and types, available on all supported platforms.
 
-$kotlin.concurrent: Concurrent programing API
+# Package kotlin.browser
 
-$kotlin.dom: Functions for working with the W3C DOM
+API to access the web browser DOM.
 
-$kotlin.io: IO API for working with files and streams
+# Package kotlin.concurrent
 
-$kotlin.math: Mathematics API
+Utility functions for concurrent programming.
 
-$kotlin.modules: API for defining compilation units
+# Package kotlin.dom
 
-$kotlin.template: Text processing API
+Functions for working with the W3C DOM.
 
-$kotlin.test: Functions for writing tests
+# Package kotlin.jvm
 
-$kotlin.util: Utility functions
+Functions and annotations specific to the Java platform.
+
+# Package kotlin.io
+
+IO API for working with files and streams.
+
+# Package kotlin.math
+
+Mathematics API.
+
+# Package kotlin.modules
+
+API for defining compilation units.
+
+# Package kotlin.platform
+
+APIs for customizing the code generated by the Kotlin compiler for better interoperability with
+other code on the target platform.
+
+# Package kotlin.properties
+
+Standard implementations of delegates for [delegated properties](/docs/reference/delegated-properties.html)
+and helper functions for implementing custom delegates.
+
+# Package kotlin.reflect
+
+Runtime API for [Kotlin reflection](/docs/reference/reflection.html)
+
+# Package kotlin.reflect.jvm
+
+Runtime API for interoperability between [Kotlin reflection](/docs/reference/reflection.html) and
+Java reflection.
+
+# Package kotlin.test
+
+Functions for writing tests.
+
+# Package kotlin.util
+
+Utility functions.