is there any convention how to put comment for the whole file? If I put some blank line between comment and the first class in that file, the comment is linked with that class nevertheless

the generated documentation has no concept of "files", so if you want to see your comment in the generated documentation, you need to attach it to a declaration. if you don't want to see it in the generated docs, use a regular // comment instead of a kdoc.