one big code block, plus some clarifications