flesh out portability tests a bit
todo note
docs