factor the developer's instructions from the possibly-end-user instructions

hush github, my commit summaries will be as long as i want them to be