small clarifications cc @dwaite