making it nicer
Document known shortcomings