update README; touch doc outlines