Merge branch 'develop'

# Conflicts:
#	README.md

Author: fzhinkin

.teamcity/pom.xml

@@ -0,0 +1,47 @@
+# Contributing Guidelines
+
+One can contribute to the project by reporting issues or submitting changes via pull request.
+
+## Reporting issues
+
+Please use [GitHub issues](https://github.com/Kotlin/kotlinx-io/issues) for filing feature requests and bug reports.
+
+Questions about usage and general inquiries are better suited for StackOverflow or the #io channel in KotlinLang Slack.
+
+## Submitting changes
+
+Submit pull requests [here](https://github.com/Kotlin/kotlinx-io/pulls).
+However, please keep in mind that maintainers will have to support the resulting code of the project,
+so do familiarize yourself with the following guidelines.
+
+* If you make any code changes:
+    * Follow the [Kotlin Coding Conventions](https://kotlinlang.org/docs/reference/coding-conventions.html).
+        * Use 4 spaces for indentation.
+        * Use imports with '*'.
+    * [Build the project](#building) to make sure it all works and passes the tests.
+* If you fix a bug:
+    * Write the test the reproduces the bug.
+    * Fixes without tests are accepted only in exceptional circumstances if it can be shown that writing the
+      corresponding test is too hard or otherwise impractical.
+    * Follow the style of writing tests that is used in this project:
+      name test functions as `testXxx`. Don't use backticks in test names.
+* Comment on the existing issue if you want to work on it. Ensure that the issue not only describes a problem,
+    but also describes a solution that had received a positive feedback. Propose a solution if there isn't any.
+
+## Building
+
+This library is built with Gradle.
+
+* Run `./gradlew build` to build. It also runs all the tests.
+* Run `./gradlew <module>:check` to test the module you are looking at to speed
+  things up during development.
+* Run `./gradlew <module>:jvmTest` to perform only the fast JVM tests of a multiplatform module.
+
+You can import this project into IDEA, but you have to delegate build actions
+to Gradle (in Preferences -> Build, Execution, Deployment -> Build Tools -> Gradle -> Build and run).
+
+### Updating the public API dump
+
+* Use the [Binary Compatibility Validator](https://github.com/Kotlin/binary-compatibility-validator/blob/master/README.md) for updates to public API:
+    * Run `./gradlew apiDump` to update API index files.
+    * Commit the updated API indexes together with other changes.