update readme with helpful documentation and additional notes