Json.encodeToString takes two arguments but docs show it taking only one

Describe the bug

I am trying to use Kotlin serialization for JSON.

The docs show that the latest version is 1.0.1 so I believe I have the correct version, but the examples don’t work:

val data = Project("kotlinx.serialization", "Kotlin")
val string = Json.encodeToString(data)  

When I try the same thing I get this error:

Type mismatch: inferred type is Project but SerializationStrategy<TypeVariable(T)> was expected
e: test.kt: (13, 56): No value passed for parameter 'value'

Looking at the signature of that method, I see it takes two arguments, not just one:

fun <T> encodeToString(serializer: SerializationStrategy<T>, value: T): String

I found out I can just do this instead and it works (but it’s pretty verbose and I would prefer if the documented behaviour worked!):

val serializer = serializer(Project::class.java)
val string = Json.encodeToString(serializer, data)  

Can you tell me whether the docs are wrong or the released code is wrong?

Environment

• Kotlin version: 1.4.21
• Library version: 1.0.1
• Kotlin platforms: JVM
• Gradle version: 6.7

[renatoathaydes]

For context, my Project class is actually a sealed class.

Something like this:

@Serializable
sealed class Base {
    data class Project(val name: String): Base()
}

In my tests, my imports are:

import kotlinx.serialization.json.Json
import kotlinx.serialization.serializer

I’ve actually managed to get it working with one parameter after some struggle by adding this import:

import kotlinx.serialization.encodeToString

Not entirely sure this was the problem, but it looks like it… would be great if you could improve the docs to point this out?!

[gs-ts]

if you have issues with the imports that have the same signature encodeToString, then use import alias:

import kotlinx.serialization.encodeToString as myJsonEncode and then Json.myJsonEncode(data)