fleshes out README and adds examples