far more efficient 'guess' method
update docs