Casey Liss

No, no, no, no, no, no.

No, no, no, no, no, no.

And so the funny thing is you're doing store kit two. Store kit two is light years better than store kit one.

And so the funny thing is you're doing store kit two. Store kit two is light years better than store kit one.

I don't think there is a way to cancel, by the way, within this little transactions dialogue. I apologize.

I don't think there is a way to cancel, by the way, within this little transactions dialogue. I apologize.

Yeah. But with regard to documentation, I mean, I could go on and on and on about this. Let me start by saying it actually has gotten a lot better over the last few years. I doubt I had anything to do with that, but I certainly it was late 2020 that I wrote my blog post about this, which I stand by pretty much. I mean, I think it has gotten better, but it is still not great.

Yeah. But with regard to documentation, I mean, I could go on and on and on about this. Let me start by saying it actually has gotten a lot better over the last few years. I doubt I had anything to do with that, but I certainly it was late 2020 that I wrote my blog post about this, which I stand by pretty much. I mean, I think it has gotten better, but it is still not great.

And, you know, the name of this blog post was on Apple's piss poor documentation. Which, yeah, pretty much. And I think the thing, there's two things that really chap my bottom about Apple's documentation these days. First of all, when you have either, what is it, no overview, something, something, no overview found or something like that. I forgot. No overview available. That's what it is.

And, you know, the name of this blog post was on Apple's piss poor documentation. Which, yeah, pretty much. And I think the thing, there's two things that really chap my bottom about Apple's documentation these days. First of all, when you have either, what is it, no overview, something, something, no overview found or something like that. I forgot. No overview available. That's what it is.

You see that less these days, which is great. But a lot of times what you'll see is just like a regurgitation of what the function signature is and very few other words. And this is like what you were describing, John, with like, here's a single sentence with a bunch of proper nouns that I'm not familiar with. Also not helpful. And that really is frustrating, really, really frustrating.

You see that less these days, which is great. But a lot of times what you'll see is just like a regurgitation of what the function signature is and very few other words. And this is like what you were describing, John, with like, here's a single sentence with a bunch of proper nouns that I'm not familiar with. Also not helpful. And that really is frustrating, really, really frustrating.

Or I love seeing, like, enumerations where each of the cases is just a restatement of the case. Like, yes, no, maybe. Like the comments that add one to I. Right. It's just bananas. But the other thing that really I find deeply frustrating, and Apple has an affordance for this in their documentation, but a lot of times there's not a really great –

Or I love seeing, like, enumerations where each of the cases is just a restatement of the case. Like, yes, no, maybe. Like the comments that add one to I. Right. It's just bananas. But the other thing that really I find deeply frustrating, and Apple has an affordance for this in their documentation, but a lot of times there's not a really great –

overview of here's this system here's how it works or secondarily here's the overview which sometimes does exist but here's how you actually execute right so take store kit for example they have a pretty great overview of here's all the things you need to consider and here's what this does and that does and subscriptions and non-subscriptions and this that and the other thing but you

overview of here's this system here's how it works or secondarily here's the overview which sometimes does exist but here's how you actually execute right so take store kit for example they have a pretty great overview of here's all the things you need to consider and here's what this does and that does and subscriptions and non-subscriptions and this that and the other thing but you

They don't do a particularly good job at all of really explaining why the API is as kooky as it is. Because StoreKit 2's API is actually really good. It's actually not that kooky. But when you want to figure out, is this app purchased? Yes or no? In order to figure that out, Apple's basically like...

They don't do a particularly good job at all of really explaining why the API is as kooky as it is. Because StoreKit 2's API is actually really good. It's actually not that kooky. But when you want to figure out, is this app purchased? Yes or no? In order to figure that out, Apple's basically like...

you got to look at like 300 different arrays of information and I don't know, piece it together yourself, have fun. And I understand why that is, but first of all, it would be nice if Apple kind of solved this for us. But second of all, There's like maybe a couple of sentences that explain why this is the way this is, and that's it.

you got to look at like 300 different arrays of information and I don't know, piece it together yourself, have fun. And I understand why that is, but first of all, it would be nice if Apple kind of solved this for us. But second of all, There's like maybe a couple of sentences that explain why this is the way this is, and that's it.