3 ms·
1) >>> Stripe runs on written long-form documents in a way that I haven’t seen before. <<< 2) >>> The product shaping document will come at it from the perspec
by nocommandline 5y ago
1) >>> Stripe runs on written long-form documents in a way that I haven’t seen before. <<<
2) >>> The product shaping document will come at it from the perspective of a user. <<<
When you combine bullets 1 & 2, it makes for very good documentation. It was one of the things I loved about Stripe when I first tried to use them (plus the simplicity of the product at that time).
However, my latest experience with Stripe is that their documentation is becoming similar to Google documentation i.e. multiple pieces of documentation describing the same thing but the different documentation is not consistent especially when they are using the same scenario. For example, you might see 2 different documents (from Stripe) that talk about embedding an online payment form and those 2 would have the same example but one would give the impression that you only need to deal with X attributes while the other one will show you that you actually need Y attributes. Some of the attributes could also be named differently (the name has probably changed and one document has not been updated while the other has or was written after the attribute was changed).
- sciprojguy 5y agoThis is similar to my experience. My company <redacted> is doing a stripe integration and I wasted a week playing with the multiple different sample apps that were provided "as is" and only made significant progress by ignoring them and building my prototype up section by section from the "getting started" documentation.
- deleted 5y ago[deleted]
- jordan-stripe 5y agoHi! I'm Jordan, a manager on the Documentation team at Stripe. Thank you (and thank you to others on thread) for sharing this valuable feedback. It would be great to get more details about your experience. This kind of feedback allows us to make specific changes that will help you (and likely many other users) in the near term. Drop me a line at jordan@stripe.com and I'd be more than happy to chat.