Update readme with project manifesto
split out to separate li.  slight cleanup
debugging - somethings not right