improved docs, added sanity-check perf test