perf: a bit of documentation