naming-conventions - functions - return fun kotlin
Convenciones de nomenclatura de archivos para Kotlin (2)
Aún puedes usar esa regla de Java como una convención y nombrar tus archivos después de tus clases. O puede comenzar a colocar más clases en un solo archivo Kotlin, en cuyo caso recomendaría nombrar los archivos según su propósito. Por lo general, cada archivo contendrá clases u otros elementos de nivel superior relacionados entre sí (si no lo son, ¿tal vez no pertenezcan al mismo archivo en primer lugar?). Debe haber una sola palabra o un pequeño número de palabras que expresen el propósito de todas las clases en un solo archivo, que es un candidato natural para el nombre del archivo.
Kotlin elimina la restricción de Java "una clase pública superior por archivo", que he aprendido a amar. Me pregunto si hay razones para que esto se discuta en alguna parte y si hay algunas pautas sobre cómo lidiar con esta nueva libertad.
En Kotling.org puede encontrar el documento de Kotling.org que responde a todas sus dudas.
Si puedo, creo que estas secciones tomadas de la página mencionada pueden ser útiles para usted:
Nombres de archivos fuente
Si un archivo Kotlin contiene una sola clase (potencialmente con declaraciones de nivel superior relacionadas), su nombre debe ser el mismo que el nombre de la clase, con la extensión .kt adjunta. Si un archivo contiene varias clases, o solo declaraciones de nivel superior, elija un nombre que describa lo que contiene el archivo y nombre el archivo como corresponda. Use jorobas de camello con la primera letra en mayúscula (por ejemplo, ProcessDeclarations.kt).
El nombre del archivo debe describir lo que hace el código en el archivo. Por lo tanto, debe evitar el uso de palabras sin sentido como "Util" en los nombres de archivos.
y...
Organización de archivos de origen
Se recomienda colocar varias declaraciones (clases, funciones de nivel superior o propiedades) en el mismo archivo fuente de Kotlin siempre que estas declaraciones estén estrechamente relacionadas entre sí de forma semántica y el tamaño del archivo sea razonable (sin exceder unos pocos cientos de líneas). En particular, al definir funciones de extensión para una clase que son relevantes para todos los clientes de esta clase, colóquelas en el mismo archivo donde se define la clase en sí. Al definir funciones de extensión que solo tienen sentido para un cliente específico, colóquelas junto al código de ese cliente. No cree archivos solo para contener "todas las extensiones de Foo".
... pero, por favor, consulte el documento para cualquier otra inquietud que pueda tener.
Creo que el punto principal es elegir una convención de codificación que funcione para su equipo. Dicho esto, creo que esta convención de Kotlin.org podría considerarse como una especie de estándar, que esperaría que al menos cualquier desarrollador de Kotlin lo conozca, si no se sigue, y la opción predeterminada para cualquier proyecto a menos que existan razones convincentes cambiar.