add a docs section for README

This has been added to play-doh. Adding it back here too.

cc @sh1mmer @dfellis