Hacker News new | ask | show | jobs
by mikeappell 2260 days ago
> - There seemed to be 3 or so quickstarts/tutorials for the same developer flow, at varying levels of detail (good), but they all had similar names and were difficult to distinguish from each other. My impression was that they were built on top of each other (i.e. one was X years old, another one X-2, etc.), but the old ones weren't removed? Unsure.

Second this. Stripe's documentation is generally great, but when looking for recipes/tutorials you run into a lot of seemingly duplicative content which makes it confusing to figure out which is right for you. I had this issue trying to create Connected Payments, specifically.

2 comments

I want to third this, this last week I've been integrating payments and I'll soon be adding in Connect as well. It took me quite a bit of back and forth on whether to use Checkout or Elements and I then ended up with 2 different recipes which resulted in the same thing but both highlighted different "important information".

Eventually I just picked one and it seemd to work out really well though. I've also recently been working with the slack docs and they're the total extreme, 8 different guides with similar names and various different deprecation notices around.

On the upside I felt like having both recipes was really useful to get a good overview of the options and possibilities. I'm really happy with my implementation now and I don't think slotting in Connect should be too tricky. Using the stipe docs was a breath of freshair compared to the Slack api docs which I've been using recently and have been an abysmal experience filled with hundreds of open browser tabs.

We just revamped our Connect docs... would love to hear any thoughts you have on the revised version. (Feel free to email me directly -- patrick@stripe.com -- and I'll forward your thoughts to the team.)
Oh hey, just saw your response =)

Not something I'm likely to be looking at in the nearish future, but the next time I need to do some refactoring/rolling out a new Stripe feature, I'll definitely drop you a line with my thoughts. Thanks for the heads up!