added logging, updated docs, etc