Two parts to this. 1. Decide our convention and document in #523. 2. Fix inconsistencies in the current codebase.