just wanted to leave an issue here to remember to deal with this. Put a brief orientation to hyperopt and related tools at http:hyperopt.github.io. (ideas @dwf)