updates docs & fixes #445