readme, and proper scoping