Add docstrings
Implement clear_values
Remove comment per discussion in #236