document the declare all the variables in the function's head, for JS scoping reasons thing

[tantek]

From @tabatkins https://twitter.com/tabatkins/status/935255134635884544

document the "declare all the variables in the function's head, for JS scoping reasons" thing that Cassis requires