[#1247] Add javadocs which tell the limitation of the type detection as there is nothing we can do about