updated views and commented spec to match doc