The location of KDoc in the code is not specified well

[vmishenev]

class Foo(
  /**
   * This is a bar property
   */
  val bar: String
)

or the example from Dokka's codebase

dokka/dokka-subprojects/core/src/main/kotlin/org/jetbrains/dokka/configuration.kt

Line 90 in d4d457d

val scopeId: String,

This case works for the Dokka and IDE.

Also, it works for a value parameter in a primary constructor.

There is the more weird case (working in the Dokka and IDE):

class /**This is a class*/ Foo (
     p: /**This is a param*/ Int
)

From the current KDoc documentation for @property

This tag can be used for documenting properties declared in the primary constructor, where putting a doc comment directly before the property definition would be awkward.

Maybe, to resolve this issue, we need to have a style guide like Javadoc's one.