Kotlin/api-guidelines

Best practices to consider when writing an API for your library

Stars: 154
Forks: 25
Open beginner issues: 0
Indexed issues: 7
Avg merge: 19d 1h
Merged PRs (30d): 1

Dominant language: No language data
License: Apache-2.0
Last GitHub push: Sep 7, 2026
Latest indexed: Sep 18, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Open All

7 open issues indexed

Extend best-practice list: recommend using typed units instead of integer-based conversions Open

Kotlin/api-guidelines#6 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
Extend best-practice list: avoid using static "global mockable state" providers/top-level functions in the favour of injectable ones Open

Kotlin/api-guidelines#7 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
[Discuss] Best-practice to prefer lists over arrays in any form Open

Kotlin/api-guidelines#8 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 18, 2026
Explain deprecation cycle and best-practices regarding backwards-incompatible API evolution Open

Kotlin/api-guidelines#13 · 0 comments · 3 reactions · 0 assignees · Indexed Sep 18, 2026
[To discuss] Explain the difference between arithmetic- and storage- primitive types Open

Kotlin/api-guidelines#15 · 5 comments · 1 reaction · 0 assignees · Indexed Sep 18, 2026
Cover tooling Open

Kotlin/api-guidelines#20 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026
Add a section on the importance of apiVersion, Xjdk-release, and java'c release Open

Kotlin/api-guidelines#44 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 18, 2026

A short digest of beginner-friendly GitHub issues.