I find the layout to be very refreshing. Whoever put it together did a pretty sweet job since it doesn't feel like reading the usual technical guide on how to use XYZ.
I really respect these guys for taking on one of the most soul sucking dev jobs which is API integration and make it work. And they integrate hundreds of APIs! I would just go crazy if it was my day job.
Of course, there is a lot of nuance in the OAuth spec(s), but we didn't feel the need to be that verbose for an "An Introduction to APIs". We'd love to hear more about what broad but important aspect of OAuth that we missed! We'll absolutely make revisions and updates.
Looks cool, but I really get a little tweaked when incomplete things are shared like this. To me, it's not useful if I can't read through and work the whole guide, which leaves this one somewhere between email-bait to get updates on the end or just regularly incomplete.
I see it as more of a multi-part blog series, where you can read the first few parts and wait for the rest, or you can wait until all parts have been written and read it all. In this case, it's better than a blog series, because you can be notified as soon as it's complete without having to keep checking back.
