long view
validation docs
uri docs and some mild refactor