Re: [webpayments] Abstract payment architecture (#11)

Hey Adrian, I think you've successfully generalized the components necessary for a functioning payment system. A few thoughts on how to improve the presentation (as I haven't yet had enough time to form any opinions on the components).

While reading through the document, I found it difficult to figure out how everything fits together. Leading on the  https://github.com/w3c/webpayments/wiki/Components page with an image and brief summary of the components would have been helpful. There are two ways you could do this that I can think of:

1. Show the image of all the components and what talks to what. Have a table below with brief 1-2 sentence descriptions of what each component does.
2. Show a simple credit card purchase flow with all of the components. Have a table below with a brief 1-2 sentence description and what each component is doing in the flow described above.

I think doing that might help people understand how all the components play with one another first, and then you can dive into what each component does below there.

---
Reply to this email directly or view it on GitHub:
https://github.com/w3c/webpayments/issues/11#issuecomment-157259474