Add Guzzle 6 adapter docs

[ddeboer]

No description provided.

[ddeboer]

Oops wait, I forgot to add an installation section. :lol:

[dbu]

should we promote this or use the message factory?

[sagikazarmark]

I think it rather matters in a library, then an application. I would keep both and state that message factory should be used in a library.

[ddeboer]

I wanted to keep things as easy as possible for new users.

And because guzzle6-adapter requires guzzle which requires guzzle/psr7, I thought it made sense to just use Guzzle’s PSR-7 Request object here.

Added a reference to the message factory doc chapter.

[sagikazarmark]

Makes sense. Wouldn't it end up too much duplicated documentation if we have this in each client documentation?

[ddeboer]

That’s a good argument, too. Let’s try to minimize duplication where possible.

[sagikazarmark]

I think only the configuration can be different for clients. So every other usage should be the same hence the interface.

[ddeboer]

That’s true, but it makes sense to have complete example per adapter. Later we can extract this duplicated bit and make it an include (long live Sphinx 😉).

[sagikazarmark]

Cool.

[ddeboer]

Installation notes added. Now ready for merging.

[ddeboer]

I prefer this bottom section over documentation sprinkled with note and warning boxes, as they can be very distracting.

[dbu]

👍
we might want to move this into a partial that we include right away, as this page will be used as template for other adapter / client documentations.

[ddeboer]

Let’s do that in subsequent PRs for the adapters.

[ddeboer]

Updated according to feedback.

[dbu]

thanks a lot!