A modern programming language that makes developers happier.

kotlinlang

what naming convention do you use for generic type parameters? The single letter names are often too confusing for me

<#C4GKV43N2|codingconventions>, but personally if I really need multiletter names I go with all-caps, eg `MyClass&lt;SELF: Myclass&lt;SELF&gt;&gt;`.

I prefer to use `UpperCamelCase` for them as they reflect types.
The name must reflect the purpose of the parameter.

So Kotlin’s default `map`:
```
fun &lt;T, R&gt; Iterable&lt;T&gt;.map(transform: (T) -&gt; R): List&lt;R&gt;
```

I’d write as
```
fun &lt;Value, TransformedValue&gt; Iterable&lt;Value&gt;.map(transform: (Value) -&gt; TransformedValue): List&lt;TransformedValue&gt;
```

It’s clearly longer but I’ve learned from Swift that “Clarity is more important than brevity”. And that’s true! :slightly_smiling_face:
(<https://swift.org/documentation/api-design-guidelines/#clarity-over-brevity>)