This is how I like to program, I find writing the readme first helps as I can write the ideal/easiest way of using the code first as a user.

When it comes to writing code for the user Kenneth Reitz is the master in my eyes.

https://github.com/requests/requests