notes for next dev (see: '@aseaboyer')