throw away docs and restructure to match the REST idiom