replace list with manual processing to avoid NOTICE for WEB-7202 +review WEBCR-421
code conventions and docblocks for WEB-7202 +review WEBCR-421