docs review, config examples fixes, closes #25