expanded docs, as suggested