@@ -27,31 +27,39 @@ like [pipes](https://hackage.haskell.org/package/pipes) and
2727API. The streaming API of streamly is close to the monadic streams API of the
2828[vector](https://hackage.haskell.org/package/vector) package and similar in
2929concept to the [streaming](https://hackage.haskell.org/package/streaming)
30−package. In addition to streaming, streamly subsumes the functionality of list
31−transformer libraries like `pipes` or
30+package. In addition to providing streaming functionality, streamly subsumes
31+the functionality of list transformer libraries like `pipes` or
3232[list-t](https://hackage.haskell.org/package/list-t) and also the logic
3333programming library [logict](https://hackage.haskell.org/package/logict). On
3434the concurrency side, it subsumes the functionality of the
3535[async](https://hackage.haskell.org/package/async) package. Because it streams
3636and supports concurrency we can write FRP applications similar in concept to
3737[Yampa](https://hackage.haskell.org/package/Yampa) or
38−[reflex](https://hackage.haskell.org/package/reflex).
38+[reflex](https://hackage.haskell.org/package/reflex). To understand the
39+streaming library ecosystem and where streamly fits in you may want to read
40+[streaming libraries](https://github.com/composewell/streaming-benchmarks#streaming-libraries)
41+as well. Also see the [Comparison with Existing
42+Packages](https://hackage.haskell.org/package/streamly/docs/Streamly-Tutorial.html)
43+section in the streamly tutorial.
3944
4045Why use streamly?
4146
4247 * Simple list like streaming API, if you know how to use lists then you know
4348 how to use streamly.
44− * Powerful yet simple and scalable concurrency. There is no other package
45− that provides such high level and flexible concurrency support.
46− * Unifies the functionality of many other disparate packages in a single
47− concise and simple API.
49+ * Powerful yet simple and scalable concurrency. Concurrency is not intrusive,
50+ concurrent programs are written exactly the same way as non-concurrent
51+ ones. There is no other package that provides such high level, simple and
52+ flexible concurrency support.
53+ * It is a general programming framework providing you all the necessary tools
54+ to solve a wide range of programming problems, unifying the functionality
55+ provided by several disparate packages in a concise and simple API.
4856 * Best in class performance. See
4957 [streaming-benchmarks](https://github.com/composewell/streaming-benchmarks)
5058 for a comparison of popular streaming libraries on micro-benchmarks.
5159
5260 For more information:
5361
54− * [Streamly.Tutorial](https://hackage.haskell.org/package/streamly-0.1.2/docs/Streamly-Tutorial.html) module in the haddock documentation for a detailed introduction
62+ * [Streamly.Tutorial](https://hackage.haskell.org/package/streamly/docs/Streamly-Tutorial.html) module in the haddock documentation for a detailed introduction
5563 * [examples](https://github.com/composewell/streamly/tree/master/examples) directory in the package for some simple practical examples
5664
5765## Streaming Pipelines