@@ -46,7 +46,8 @@ that they use `nil` and `cons` instead of `[]` and `:`. Unlike lists, streams
4646can be constructed from monadic effects, not just pure elements. Streams are
4747processed just like lists, with list like combinators, except that they are
4848monadic and work in a streaming fashion. In other words streamly just completes
49−what lists lack, you do not need to learn anything new.
49+what lists lack, you do not need to learn anything new. Please see [streamly vs
50+lists](docs/streamly-vs-lists.md) for a detailed comparison.
5051
5152Not surprisingly, the monad instance of streamly is a list transformer, with
5253concurrency capability.
@@ -94,11 +95,9 @@ performance results and a comparison with the `async` package.
9495
9596## Installing and using
9697
97−Please see
98−[INSTALL.md](https://github.com/composewell/streamly/tree/master/INSTALL.md)
99−for instructions on how to use streamly with your Haskell build tool or package
100−manager. You may want to go through it before jumping to run the examples
101−below.
98+Please see [INSTALL.md](INSTALL.md) for instructions on how to use streamly
99+with your Haskell build tool or package manager. You may want to go through it
100+before jumping to run the examples below.
102101
103102The module `Streamly` provides just the core stream types, type casting and
104103concurrency control combinators. Stream construction, transformation, folding,
@@ -574,8 +573,8 @@ For more information, see:
574573
575574 * [Detailed tutorial](https://hackage.haskell.org/package/streamly/docs/Streamly-Tutorial.html)
576575 * [Reference documentation](https://hackage.haskell.org/package/streamly)
577− * [Examples](https://github.com/composewell/streamly/tree/master/examples)
578− * [Guides](https://github.com/composewell/streamly/blob/master/docs)
576+ * [Examples](examples)
577+ * [Guides](docs)
579578 * [Streaming benchmarks](https://github.com/composewell/streaming-benchmarks)
580579 * [Concurrency benchmarks](https://github.com/composewell/concurrency-benchmarks)
581580
@@ -601,9 +600,7 @@ See the `credits` directory for full list of contributors, credits and licenses.
601600## Contributing
602601
603602The code is available under BSD-3 license
604−[on github](https://github.com/composewell/streamly). Join the
605−[gitter chat](https://gitter.im/composewell/streamly) channel for discussions.
606−You can find some of the
607−[todo items on the github wiki](https://github.com/composewell/streamly/wiki/Things-To-Do).
608−Please ask on the gitter channel or [contact the maintainer directly](mailto:harendra.kumar@gmail.com)
609−for more details on each item. All contributions are welcome!
603+[on github](https://github.com/composewell/streamly). Join the [gitter
604+chat](https://gitter.im/composewell/streamly) channel for discussions. Please
605+ask any questions on the gitter channel or [contact the maintainer
606+directly](mailto:harendra.kumar@gmail.com). All contributions are welcome!