consolidate package docs and example into a doc file