Slight improvement of wording in the section that explains the benefits of contributing code examples for library functions
This commit is contained in:
committed by
Ilya Gorbunov
parent
e032e4ad54
commit
cbc5c6f792
@@ -117,7 +117,7 @@ and find classes or functions which are not documented very well and submit a pa
|
||||
In particular it'd be great if all functions included a nice example of how to use it such as for the
|
||||
<a href="http://kotlinlang.org/api/latest/jvm/stdlib/kotlin/hash-map-of.html">hashMapOf()</a> function.
|
||||
This is implemented using the <a href=https://github.com/JetBrains/kotlin/blob/master/libraries/stdlib/src/kotlin/collections/Maps.kt#L53">@sample</a>
|
||||
macro to include code from a test function. This serves as a double win; the API gets better documented with nice examples to help new users and the code gets more test coverage.
|
||||
macro to include code from a test function. The benefits of this approach are twofold; First, the API's documentation is improved via beneficial examples that help new users and second, the code coverage is increased.
|
||||
|
||||
Also the [JavaScript translation](https://github.com/JetBrains/kotlin/blob/master/js/ReadMe.md) could really use your help. See the [JavaScript contribution section](https://github.com/JetBrains/kotlin/blob/master/js/ReadMe.md) for more details.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user