A modern programming language that makes developers happier.

kotlinlang

Runnable_snippets_declared_in_code.kt

<@U4UGS5FC7> this way the actual result is never in the kdocs, right?

Aren’t we better of writing samples like the following then. `Option.just(1).map { it + 1 } == Some(2)`. Something in test form.

If they are runnable the result doesn't show until you play 

I meant in the Kdocs, not the arrow docs.

Ank should print out the resulting value in the rendered doc but if you want the result when people are reading the sources then yeah 

We could do something like `fun A.shouldEqual(other: A): Unit` that prints the result in runnable snippet but it showcases the result also in the actual code.

Just thinking out loud because a snippet like the following might not tell the user a lot (enough).

```
fun main(args: Array&lt;String&gt;) {
  listOf(1, 2, 3)
    .map { async { getUserById(it) } }
    .sequence(DeferredK.applicative())
}
```

```
fun main(args: Array&lt;String&gt;) {
  listOf(1, 2, 3)
    .map { async { getUserById(it) } }
    .sequence(DeferredK.applicative()) shouldEqual
       async { listOf(User(1), User(2), User(3)) }
}
```

Same here. This is immediately clear in the Kdocs IMO. <https://github.com/arrow-kt/arrow/pull/1133/files#diff-24acbdf947a678588c475a4056c19198R22>

No need to jump to website and run snippet to clarify.

yes, but as a user I still want to go and modify those values

and see how the expression behaves with different values or code

if that comparison also uses `println` for the resulting value to get the best of both worlds then yeah

yeah we were in agreement many msgs ago :stuck_out_tongue: