(maint) Write more detailed readme and add use case

Prior to this commit, the readme didn't have much information. This
commit adds more information about the design pattern and also adds a
developer API use case.