add check for deprecated config and help developers migrate.

refs #9
update configuration examples