add show overlay
update docs & style error messages