Kotlin gRPC

[chalin]

• Add placeholder pages for the quick start and tutorial so that we can link to them from other sites before the final versions are published - Add placeholders for Kotlin gRPC #141
• About page supported languages and platforms
  • Add Kotlin entry - (Add placeholders for Kotlin gRPC #141), Kotlin/JVM platforms #142
  • Remove "under development" qualifier - 59e5173
• Create Kotlin quick start - (Add placeholders for Kotlin gRPC #141), Kotlin quick start #124, Update Kotlin QS example code, and other tweaks #194
• Create Kotlin basic tutorial (docs/tutorials/basic/kotlin.md) - (Add placeholders for Kotlin gRPC #141), Kotlin tutorial #157, Update Kotlin QS example code, and other tweaks #194
• API reference:
  • Ensure API reference has been generated and is accessible; see Publish API reference to gh-pages grpc-kotlin#5.
  • Ensure that there is a link to the Kotlin API reference from the Reference page - Add link to Kotlin gRPC API ref docs, and cleanup redirects #165, Adjust API reference root package name #175
• Add Kotlin entry to packages.grpc.io - Add Kotlin grpc#22451
• Add Kotlin to grpc/grpc README - Add grpc-kotlin grpc#22450
• Merge kotlin branch into master

After launch:

• Blog post on grpc.io referring to the Google Cloud blog entry (here's the tweet) - Add gRPC-Kotlin blog entry #196
• Delete grpc-java/examples/example-kotlin - Delete example-kotlin now that grpc-kotlin 0.1.1 is out grpc-java#6936

Questions:

• Do we want to provide some guidance in terms of writing unit tests for grpc-kotlin apps (and write an example for the Hello World app)? Cf. grpc-java/examples/example-kotlin's Unit test examples

Answered:

• On which platforms (Windows, Linux, Mac) can grpc-kotlin be used?
• Router guide example:
  • Stick with proto Duration type, even if it isn't used in other examples?
  • Drop/cleanup Java specific option declarations?

[chalin]

@dwiner @lowasser @bshaffer @thisisnotapril - let me know if you see anything missing from the "to do" list in the opening comment of this issue.

[dwiner]

Thanks! Only thing I'd add is could we also add a link to gRPC Kotlin to the grpc/grpc README?

On whether we should track the main gRPC version numbers, I'm not sure but perhaps @lowasser or @bshaffer have some thoughts on this.

Finally, I think it makes sense to delete the grcp-java Kotlin example.

[lowasser]

Tracking the main gRPC versions makes sense to me. I think the Kotlin APIs will need to change less often in general, but version number mismatches are always confusing and painful.

[chalin]

@lowasser - which platforms will be supported? Cf. https://grpc.io/about/#officially-supported-languages-and-platforms. Also, how should we express the min "Compiler / SDK" entry in that page: as "Kotlin 1.3+"?

[lowasser]

Precisely the same platforms will be supported as Java. Kotlin 1.3+ should be correct.

[lowasser]

It might be worth marking it as "Kotlin/JVM" rather than "Kotlin" generically, though? We are not yet supporting the Javascript or Native compilation backends for Kotlin.

[muxi]

@srini100 - office hour cc

[chalin]

All done!