cleaned up coffee utilities; added more documentation