document early so it's easier later