improved docs for views