Use the appropriate documentation format for the target programming language. In Kotlin files, use KDoc formatting instead of Javadoc formatting for consistency and proper tooling support.

Key differences:

Example:

// โŒ Incorrect (Javadoc style in Kotlin)
/**
 * Throws an {@link AssertionException} if the current thread is not the UI thread.
 * Before calling build, the following must be called:
 * * [.setApplication]
 */

// โœ… Correct (KDoc style in Kotlin)  
/**
 * Throws an [AssertionException] if the current thread is not the UI thread.
 * Before calling build, the following must be called:
 * * [setApplication]
 */

This ensures documentation renders correctly in IDEs and documentation generators, and maintains consistency with language conventions.