maybe @User wouldn't mind if we just merge his summary back into the docs