Good writeup, thanks, Martin.
The things that still confuse me are: 1) when and why to user "current" 2) where to put "imports". since in Python we've always been told to put them at top of file. But it looks like they need to go in the def function() in order to not be loaded when other functions run.
