docs updates for once and all