add some clarifications