wip: pkg documentation update

Fully rewritten Pkg documentation for the 0.2 release.