improvements to intro, implementation, etc