https://kotlinlang.org logo
#dokka
Title
# dokka
c

CLOVIS

10/17/2023, 8:04 AM
Now that Writerside is in public beta, are there any plans to integrate it with Dokka? 😇
i

Ignat Beresnev

10/17/2023, 8:52 AM
Hey! I tried it some time ago, but I didn't see a meaningful way in which we could integrate What sort of integration are you thinking of, can you give an example? :)
c

CLOVIS

10/17/2023, 9:22 AM
For me, the most interesting things: • being able to cross-reference stuff from one to the other (e.g. in Writerside, using
[Foo][com.fully.qualified.name.Foo]
should create a link to the corresponding Dokka page) • having everything in a single site When making an application, the API docs (by Dokka) and the user guides (by Writerside) are aimed towards different people. However, most of my projects are libraries (e.g. Pedestal), both are aimed towards the same people: API docs give the details of usage, and user guides teach users how to find what they're searching for, as well as the underlying concepts. For now, I've been (ab)using the Dokka module-level page for this, but it's only really an option in case everything you want to say fits in a single page. I'm considering adopting Writerside because it is meant specifically for this use case. However, it's very important not to split the documentation in two different places—otherwise, users will only read one of them / won't know how to find things in the other one.