first commit landed! now i get to fix all the bugs that pissed me off MWAHAHAA! (this is actually the second commit, which is just a docs update for the first commit. but that one's in a private repo)