Add documentation for BatchClient, BatchResult and BatchException

[thormeier]

Solves #16

[joelwurtz]

wraps a HttpClient

[thormeier]

Fixed :)

[joelwurtz]

Awesome <3 ! 👍

[sagikazarmark]

Does the exception check make sense here? Exception is thrown if any.

[thormeier]

True. Removed it.

[sagikazarmark]

Added one comment. Please squash commits.

Thanks @thormeier

[thormeier]

Fixed mentioned things and squashed commits.

[sagikazarmark]

Thanks @thormeier

[dbu]

this is assuming that the post request did not fail and would throw an exception if it failed. in this flow of code, that can't happen as we would have bailed out with an exception. but that means $fooSuccessful is pointless. i would move the isSuccessful check below to the error handling logic, as its only relevant in the error case to figure out if something went wrong or not.

[sagikazarmark]

Wow, my breain blown up while following this reasoning (guess it's sunday evening), so I just agree with you. 😉

[dbu]

yeah, sunday evening here as well :-D i think in the middle i realized that we can just expect the response to be there in this case... but we should separate the examples to make it more clear. we could even mention that we can just assume responses are here as otherwise there would be the exception thrown.

[dbu]

thanks a lot for the contribution! i commented some details, if you find some time to clean this up, great, but at least we have some documentation now.