clarified namespace munging and flattening in readme