# Improve the Kotlin documentation **URL:** \ **Category:** Uncategorized\ **Created:** [July 21, 2016, 12:06pm UTC](https://discuss.kotlinlang.org/t/improve-the-kotlin-documentation/1879 "2016-07-21T12:06:04Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![medium](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.kotlinlang.org/medium/32/10404_2.png) [@medium](https://discuss.kotlinlang.org/u/medium)\ **Post date:** [July 21, 2016, 12:06pm UTC](https://discuss.kotlinlang.org/t/improve-the-kotlin-documentation/1879/1 "2016-07-21T12:06:04Z")
I’ve just looked at [FileTreeWalk](http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.io/-file-tree-walk/index.html#) and find it not overly helpful. - The page doesn’t show how to actually use the class. There are very view examples in the docs. - The page lists private constructor parameters. There is not hint how to obtain an instance. - There is no compact overview over all methods (like in JavaDoc, ScalaDoc) - Sometimes the return type is the thing to look for, what is very easy in JavaDoc - [ScalaDoc](http://www.scala-lang.org/api/2.11.8/#package) has a nice filter to reduce the list of classes. - There is no overview over all class like in JavaDoc or ScalaDoc. It would be nice, if the Kotlin documentation could be redesigned in a way, that the above points would be improved. ---
**Author:** ![yole](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.kotlinlang.org/yole/32/1425_2.png) [@yole](https://discuss.kotlinlang.org/u/yole)\ **Post date:** [July 21, 2016, 12:39pm UTC](https://discuss.kotlinlang.org/t/improve-the-kotlin-documentation/1879/2 "2016-07-21T12:39:49Z")
- I’m not sure what you mean by “There is no compact overview over all methods”. The “Functions” section in the page you have linked to is intended to perform exactly that role. How is it different from what you expect to see? - What exactly do you mean by “Sometimes the return type is the thing to look for, what is very easy in JavaDoc”? How exactly would you expect the documentation to be changed to address this suggestion ? - The overview of all classes is available here: [alltypes - Kotlin Programming Language](https://kotlinlang.org/api/latest/jvm/stdlib/alltypes/index.html) The rest are valid points; we’ll address them, but it doesn’t look like this would require a redesign of the entire documentation system. ---
**Author:** ![medium](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.kotlinlang.org/medium/32/10404_2.png) [@medium](https://discuss.kotlinlang.org/u/medium)\ **Post date:** [July 21, 2016, 2:24pm UTC](https://discuss.kotlinlang.org/t/improve-the-kotlin-documentation/1879/3 "2016-07-21T14:24:54Z")
> I’m not sure what you mean by “There is no compact overview over > all methods”. The “Functions” section in the page you have linked to is > intended to perform exactly that role. How is it different from what you > expect to see? I mean an overview with just the method signature and a short (single sentence) description, like in JavaDoc: > Predicate asPredicate() > Creates a predicate which can be used to match a string. > static Pattern compile(String regex) > Compiles the given regular expression into a pattern. This short description could then be expanded inline or link to a longer description. > What exactly do you mean by “Sometimes the return type is the thing to > look for, what is very easy in JavaDoc”? How exactly would you expect > the documentation to be changed to address this suggestion ? I found it practical from time to time, that the return type is the first column in JavaDoc. Let’s say I know, that I want a `String`, but don’t know the method name, I would just scan for `String` and find the method (like File.readText()). > The overview of all classes is available here: [alltypes - Kotlin Programming Language](https://kotlinlang.org/api/latest/jvm/stdlib/alltypes/index.html) Ok, exists, but what I meant was a “frame” (not necessarily a HTML frame) with all classes grouped by packages like ScalaDoc has. I really like ScalaDoc and consider it the best API doc design so far. Maybe this could be a source of inspiration. > but it doesn’t look like this would require a redesign of the entire documentation system. “redesign” was meant in a layout sense. I’m happy to hear, that you are further improving the documentation. ---
**Author:** ![ilya.gorbunov](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.kotlinlang.org/ilya.gorbunov/32/1645_2.png) [@ilya.gorbunov](https://discuss.kotlinlang.org/u/ilya.gorbunov)\ **Post date:** [August 1, 2016, 6:00pm UTC](https://discuss.kotlinlang.org/t/improve-the-kotlin-documentation/1879/4 "2016-08-01T18:00:29Z")
> [@medium](#): > > I mean an overview with just the method signature and a short (single sentence) description, like in JavaDoc That’s exactly how the documentation is rendered, isn’t it? Anyway, I’ve filed an issue to clarify the documentation of `FileTreeWalk`: [https://youtrack.jetbrains.com/issue/KT-13297](https://youtrack.jetbrains.com/issue/KT-13297). ---
**Author:** ![medium](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.kotlinlang.org/medium/32/10404_2.png) [@medium](https://discuss.kotlinlang.org/u/medium)\ **Post date:** [August 7, 2016, 8:52pm UTC](https://discuss.kotlinlang.org/t/improve-the-kotlin-documentation/1879/5 "2016-08-07T20:52:13Z")
> That’s exactly how the documentation is rendered, isn’t it? No, it’s not! See for example the API doc of the [Array](http://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html) class. ![](https://us1.discourse-cdn.com/flex019/uploads/kotlinlang/original/2X/2/2c90fcd7d5ade6a6957ed30590e4b247140e8504.png) There is much more than just a sentence. And there is no additional overview like in JavaDoc.