improve docs and add assets + asset-types flags, clearer

improve docs and add assets + asset-types flags, clearer #11