functionality and clarity updates