more preview explanation and cleanup

relates #235, #231, #208