akka/akka-core
Rewrite Future docs, they miss to show best practices and traps
开放
#23,948 创建于 2017年11月9日
1 - triagedhelp wantedt:docs
仓库指标
- 星标
- (13,277 个星标)
- PR 合并指标
- (平均合并 8天 19小时) (30 天内合并 10 个 PR)
描述
Current Future docs are rather ancient and focused on showing off the Future API, and Await actually. I think we're in real need of rewriting these two pages:
- https://doc.akka.io/docs/akka/current/scala/futures.html
- first thing we show in using with actors is Await
- we barely mention pipeTo, without real complete example
- we don't mention the usual danger of mutating things from a Future with examples
- https://doc.akka.io/docs/akka/2.5/scala/general/jmm.html#jmm-shared-state