some minimal documentation so I remember what I was thinking