fleshing out the user manual. WIP.