Update the builder creation guidelines to clarify that the builder constructor must be public even if Kotlin users are expected to implicitly leverage the builder through a factory method/dsl style creation mechanism.
PiperOrigin-RevId: 633242814
Change-Id: I728aa13bab2e3b13a2d0dfedf55f166333aea9a0
diff --git a/api-guidelines/methods.md b/api-guidelines/methods.md
index 14ad03a..53b5724 100644
--- a/api-guidelines/methods.md
+++ b/api-guidelines/methods.md
@@ -269,7 +269,10 @@
To ensure consistent builder creation through Android API surface, all the
builders *must* be created through a constructor and not a static creator
-method.
+method. For Kotlin-based APIs, the `Builder` must be public even if Kotlin users
+are expected to implicitly leverage the builder through a factory method/DSL
+style creation mechanism. Libraries **must not** use `@PublishedApi internal` to
+selectively hide the `Builder` class constructor from Kotlin clients.
```java {.bad}
public class Tone {
