always write a scoping document first, glam