explain a few things about this branch

for @daemianmack and anyone else