fleshes out documentation with examples