[Suggestion]: An examples directory would be great

An examples directory which some implementations of common usages would be great.

For example, I was trying to implement get a basic api fetch to give the library a test-ride but I couldn’t get it working. Hopefully, if I ever get a hang of the library, I could contribute examples myself but that is not something I can do right now.

Btw, I wanted to say that the library looks great!

(P.S Since I’m here, could some github tags be added so the library is more discoverable? I couldn’t recall its name once and I couldn’t find it when I was searching for functional monad etc)

[pandu-supriyono]

Great, in that case I’m on it. Did you already happen to have something in mind with regards to how the examples should look?

I’m thinking something to the likes of:

|
| -- src/
| -- examples/
    | -- package.json
    | -- README.md
    | -- synchronous.ts
    | -- asynchronous.ts
    | -- http-client.ts <-- a more integrated/contextually rich example combining sync and async functions, 
                            as well as some utility functions in a trivial Koa or Express app?

I’ll keep in mind to leave the FP terms behind considering the design philosophy of this lib. In my opinion, the idea of composing safe functions deserves quite some attention and I would emphasize that in the examples.

[pandu-supriyono]

Late to the party, and I feel like the examples in the API docs are quite good already.

Though I can understand that someone might need more contextually rich examples.

I’ve been playing around with the library and checking out the source and am feeling quite comfortable enough to work on this if you feel this is necessary.