proof & revise docs up to & incl selectors