tweaking docs again and starting small re-work of ch interface