primer: production notes and updating includes