Developer doc improvements

Thanks @zackgalbreath for the feedback