Add examples to documentation

[ExcaliburZero]

Add some examples of common uses of the library to the documentation.

[mrkkrp]

Thanks for caring. A few points here:

• The example in the header is not valid Haskell. zipPath <- parseRelFile … cannot appear “naked” on the top level. You probably indented this to be executed in GHCi, but then you need to use different markup in Haddocks. I think it's better to write proper Haskell functions instead as it's made in other libraries worknig with Zip archives.
• The second addition is redundant. Since ZipArchive is a monad, it sure can be combined with (>>). I think trying to repeat basics of Haskell in docs of every package is a futile effort.

You can amend your commit and fix it according to my feedback, or I can change it myself later today.

[coveralls]

Coverage remained the same at 85.414% when pulling c3078b4 on ExcaliburZero:doc into 87c16b3 on mrkkrp:master.

[ExcaliburZero]

Thanks for the feedback!

I'll change the example to use a function rather than ghci input, and remove the information on combining ZipArchive actions.

When I was first trying to work with this library, the matter of combining multiple actions into a single action was fairly confusing, as I am not very familiar with Haskell. Perhaps it may be a good idea to include an example of working with multiple actions just to make the process more clear.

[mrkkrp]

Well, comining monadic actions is a very common thing in Haskell. I think it's safe to assume that users of the library know how to do it. You can pick a book on Haskell that explains that. It's always better to start with a book than exploring things on your own.

[ExcaliburZero]

Okay, I've made the changes you mentioned. Let me know if any other changes are needed.

[coveralls]

Coverage remained the same at 85.414% when pulling 32d38a0 on ExcaliburZero:doc into 87c16b3 on mrkkrp:master.

[coveralls]

Coverage remained the same at 85.414% when pulling 32d38a0 on ExcaliburZero:doc into 87c16b3 on mrkkrp:master.

[mrkkrp]

Applied as 692079a. Your Haskell doesn't look idiomatic yet, so went ahead and added some examples of my own. I hope this decision is understandable. Thanks.