update docs and cut down attribute level of detail