perf: cache matrix creation
update docs slightly