Skip to content

Commit 1c5c134

Browse files
committed
docs/android: Add more links about Kotlin.
This clears a bunch of tabs I had open as resources that should be helpful.
1 parent 99c049f commit 1c5c134

File tree

1 file changed

+26
-1
lines changed

1 file changed

+26
-1
lines changed

docs/architecture/android.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,14 +97,39 @@ general, algorithm for learning is:
9797
5. Do the thing you just learned how to do, and repeat from step 1.
9898

9999
Good resources for looking things up and learning more include:
100-
* [Kotlin reference docs] upstream -- tons of good stuff here.
100+
* [Kotlin reference docs] upstream -- tons of good stuff here,
101+
including many pages you'll definitely want to read eventually.
102+
Here's an incomplete list:
103+
* Key concepts that don't exist in Java:
104+
[null safety], [extensions], [inline functions].
105+
* Key concepts that exist in Java but with differences:
106+
[control flow (especially `when`)][control-flow];
107+
[classes].
108+
* Some [Kotlin idioms]. This one is like StackOverflow answers;
109+
once you find something relevant here, you'll want to go look up
110+
its real documentation.
101111
* [Kotlin standard library reference][kotlin-stdlib]; especially on
102112
[collections (List, Iterable, Map, etc.)][kotlin-collections].
113+
* A [Kotlin style guide][android-kotlin-style],
114+
and a [bonus style guide][android-kotlin-java-interop] for Kotlin
115+
code that'll be used from Java. These come from Android upstream,
116+
but their content isn't specific to Android.
117+
* [Android KTX], a library that uses Kotlin features to provide nicer
118+
interfaces to Android APIs.
103119
* Various resources linked from [Android upstream][android-kotlin-resources].
104120

105121
[Kotlin reference docs]: https://kotlinlang.org/docs/reference/basic-types.html
122+
[null safety]: https://kotlinlang.org/docs/reference/null-safety.html
123+
[extensions]: https://kotlinlang.org/docs/reference/extensions.html
124+
[inline functions]: https://kotlinlang.org/docs/reference/inline-functions.html
125+
[control-flow]: https://kotlinlang.org/docs/reference/control-flow.html
126+
[classes]: https://kotlinlang.org/docs/reference/classes.html
127+
[Kotlin idioms]: https://kotlinlang.org/docs/reference/idioms.html
106128
[kotlin-stdlib]: https://kotlinlang.org/api/latest/jvm/stdlib/index.html
107129
[kotlin-collections]: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index.html
130+
[android-kotlin-style]: https://developer.android.com/kotlin/style-guide
131+
[android-kotlin-java-interop]: https://developer.android.com/kotlin/interop#kotlin_for_java_consumption
132+
[Android KTX]: https://developer.android.com/kotlin/ktx.html
108133
[android-kotlin-resources]: https://developer.android.com/kotlin/resources
109134

110135

0 commit comments

Comments
 (0)