Add space between function description and function signature in docs

[1Jajen1]

https://next.arrow-kt.io/docs/apidocs/arrow-core-data/arrow.core/-either/index.html

This just does not look right and it's a pain to read.

[1Jajen1]

Btw this still happens on the new docs.

[calvellido]

Thanks a lot for pointing this out @1Jajen1.

The source of this is the automated docs generation through Dokka, where we haven't been able yet to found a suitable way to modify this accordingly. We have been trying different approaches, but none really fix this in a clean way.

In Arrow Meta we are trying to overcome this through some CSS, but in a way that introduces some unnecessary line breaks:

https://meta.arrow-kt.io/docs/apidocs/compiler-plugin/arrow.meta.dsl.codegen.asm/-asm-syntax/

I'll try to share any advances we can make in this regard, cheers!

[i-walker]

There is a fix here. Once it is included in the next Dokka release iteration, we may update the Dokka version. Kotlin/dokka#613

[calvellido]

Amazing @i-walker! 🙌