lots of tweaks to the post, based on josh's feedback