expand on error handling, change return type for revisions, which don't support text/css
documentation