[threatofrain]

I wouldn't focus on the fact that the examples are on single functions. Libraries and frameworks are about API design and not individual atoms, and writing your documentation ahead of time is about crystalizing the API vision you have in your head.

One may have accidentally glossed over a critical design decision and this process can surface that.