search

connectrpc / connectrpc.com

Docs, governance, and RFCs for Connect: Protobuf RPC that works.
https://connectrpc.com
Apache License 2.0
15 stars 18 forks source link

Hello world with Buf examples, starting from Java #69

Open edmondop opened 11 months ago

edmondop commented 11 months ago

At the moment, the documentation contains a non-trivial example for Kotlin, which is a little counterintuitive. I propose the documentation offer "hello world"-style examples that only focus on the specific of setting up Connect in a specific language, leaving more advanced features and use cases in a separate section of the doc.

Also, since Java is still a popular language, and Kotlin is Java compatible, probably it would be great to have a "Getting started with Java" that mentions that the code generated is in Kotlin, and you need a certain setup, but you can use Connect when coding in Java

Reference: https://connectrpc.com/docs/kotlin/getting-started/

akshayjshah commented 11 months ago

Hey @edmondop! We intended the Swift and Kotlin implementations to be primarily for mobile developers - that's why they're client-only. Eventually, we'd like to have a full Java implementation. (If you're interested, leave a response on https://github.com/orgs/connectrpc/discussions/11.)

All that said, we should provide a simpler example for server-side Java developers to get started with our Kotlin clients. It probably won't happen soon unless you'd like to open a PR 😉, but we'll get to this eventually!

edmondop commented 10 months ago

I'll open myself a PR soon :) I would have liked to do this sooner but I was too busy:)