some updates and clarifications