long overdue update to docs