Blog Infos
Author
Published
Topics
,
Published
Topics
,

We all know that “Good code documents itself” but documenting your code won’t hurt anyone’s(especially Vegita’s) pride.

But HOW?

To write documentation for Kotlin code we can use the following plugin:

KDoc-er – Kotlin Doc Generator – IntelliJ IDEs Plugin | Marketplace

With the plugin, we can automatically generate Kdocs like this:

/**
 * Image view show image from url
 *
 * @param imageUrl url of the image
 */

Once we are done with the Kdoc it is time to show off what we have done and we need Dokka for that.

Dokka

We have to add Dokka to our project

1- At the project level Gradle file
dependencies {
    classpath "org.jetbrains.dokka:dokka-gradle-plugin:1.6.0"
}
2- In each module Gradle that we want to document
apply plugin: "org.jetbrains.dokka"
Note:

Make sure that:

1- Your Gradle, android studio and project use java 11 (check by terminal with ./gradlew — version)

2- Dokka plugin must be applied after “com.android.application” and “org.jetbrains.kotlin.android”

After sync and rebuild (to make sure we can invalidate cache as well but it is optional) in terminal we will call one of the following lines:

1- ./gradlew dokkaHtml dokkaHtmlMultiModule (for multi module)

2- ./gradlew dokkaHtml dokkaHtml (for single module)

Once Dokka is done you can open index.html from the browser and well-written documentation is in front of you.

References and More

1- Raywanderlich

2- Ahmetburakilhan’s article

3- Dokka

With Special Thanks To

This article was originally published on proandroiddev.com on July 02, 2022

Job Offers

Job Offers


    Developer Relations Engineer

    Embrace
    United States
    • Full Time
    apply now

    Android Team Lead

    Komoot
    Remote EMEA
    • Full Time
    apply now

    Information Security Engineer

    MongoDB
    London, UK
    • Full Time
    apply now
Load more listings

OUR VIDEO RECOMMENDATION

, ,

Keynote: Kotlin and the Multiplatform Future

While Kotlin started on the JVM, and subsequently gained adoption in the Android community, it has evolved into a language that supports many platforms. Kotlin Multiplatform has emerged as a technology that allows us to…
Watch Video

Keynote: Kotlin and the Multiplatform Future

Hadi Hariri
Never believed in elevator pitches

Keynote: Kotlin and the Multiplatform Future

Hadi Hariri
Never believed in el ...

Keynote: Kotlin and the Multiplatform Future

Hadi Hariri
Never believed in elevato ...

Jobs

YOU MAY BE INTERESTED IN

YOU MAY BE INTERESTED IN

blog
It’s one of the common UX across apps to provide swipe to dismiss so…
READ MORE
blog
Hi, today I come to you with a quick tip on how to update…
READ MORE
blog
Automation is a key point of Software Testing once it make possible to reproduce…
READ MORE
blog
Drag and Drop reordering in Recyclerview can be achieved with ItemTouchHelper (checkout implementation reference).…
READ MORE

Leave a Reply

Your email address will not be published. Required fields are marked *

Fill out this field
Fill out this field
Please enter a valid email address.

Menu