wrote documentation; changed evaluation function signature
updated test to reflect changed eval func sig