Revert "very simple error detection"

This reverts commit eff2829293ee023d6a2d750a8ff6499bd2e08327.
added explanation blurb; mixed interface order