update docs for init selection. closes #912