akka/akka-core
Rewrite Future docs, they miss to show best practices and traps
オープン
#23,948 opened on 2017/11/09
1 - triagedhelp wantedt:docs
Repository metrics
- Stars
- (13,277 個のスター)
- PR merge metrics
- (平均マージ 8d 19h) (30d で 10 merged PRs)
説明
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