resolves #1: lots of docs