finished writing refactoring best practices guide
fixed reference in doc
re-exposed a class needed for theano_linear tests