The only reasons we don’t have a wiki for `kotlinx...
# coroutines
e
The only reasons we don’t have a wiki for
kotlinx.coroutines
is because we are still evolving it and bits of syntax and behavior might change from release to release. It is easier to keep docs versioned together with sources (both guides and kdocs). You cannot do this with wikis. Risks are high you will end up with outdated wikis (for example,
CoroutineScope.context
was deprecated recently, renamed to
coroutineContext
— it was easy to push it into all the guides and kdocs with a single commit)
v
I think it is the same as official blog posts - before 1.0 kotlin changed a lot and blog posts (even by JB) got outdated, but still they provided a ton of value
e
Blogs are a different medium, imo. People expect blogs to get outdated over time, while wiki is expected to have up-to-date docs