add magic function note
read the docs
add stupid python tricks
clean up even further and relocate