O'Reilly logo

Kotlin in Action by Svetlana Isakova, Dmitry Jemerov

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Appendix B. Documenting Kotlin code

This appendix covers writing documentation comments for Kotlin code and generating API documentation for Kotlin modules.

B.1. Writing Kotlin documentation comments

The format used to write documentation comments for Kotlin declarations is similar to Java’s Javadoc and is called KDoc. Just as in Javadoc, KDoc comments begin with /** and use tags starting with @ to document specific parts of a declaration. The key difference between Javadoc and KDoc is that the format used to write the comments themselves is Markdown (https://daringfireball.net/projects/markdown) rather than HTML. To make writing documentation comments easier, KDoc supports a number of additional conventions to refer to documentation elements ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required