inverting the resolution process. adding docs, adding example.