added better non-buggy docs