re-org docs
more docs
update docs
docs
add picture

Also stash some earlier experiment.