Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Api documentation #27

Closed
kfh opened this issue Jan 9, 2023 · 4 comments
Closed

Api documentation #27

kfh opened this issue Jan 9, 2023 · 4 comments

Comments

@kfh
Copy link

kfh commented Jan 9, 2023

Just discovered this nice little library and while playing around i thought it would be useful to have docs of the full api available. What about using Dokka for a nice viewing experience ?

@aSemy
Copy link
Contributor

aSemy commented Jan 9, 2023

Hi, thanks for the interest!

Publishing docs is something I want to do.

I've been working on setting up a GitHub Pages site, with demonstrations of functionality, that are automatically tested. The result would be similar to https://adamko-dev.github.io/kotlinx-serialization-typescript-generator/. Would that suit your needs?

I'm not a big fan of Dokka. It's slow, and the Gradle plugin doesn't follow the Gradle API correctly which causes build problems. I think that publishing the sources JAR is good enough for usage within IDEs.

@aSemy aSemy closed this as completed Jan 9, 2023
@aSemy aSemy reopened this Jan 9, 2023
@kfh
Copy link
Author

kfh commented Jan 12, 2023

Thanks for the feedback. I just wanna get a quick view of the API without opening an editor. Whether i'm on the phone or in front of my computer. I do like how Dokka presents the code but if you have other solutions in mind that's not a big issue for me.

@aSemy
Copy link
Contributor

aSemy commented Mar 13, 2023

Hey @kfh, I've just finished with the API docs

https://adamko-dev.github.io/kotka-streams/

What do you think?

@aSemy aSemy closed this as completed Mar 16, 2023
@kfh
Copy link
Author

kfh commented Mar 22, 2023

Hey @kfh, I've just finished with the API docs

https://adamko-dev.github.io/kotka-streams/

What do you think?

Yeah, this looks good 👌 Exactly what i felt was missing. Great work

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants