add better docs, use object type rather than specifically 'select' as to how it renders the markup