docs + bug fixes