complete the README; add a diagram