WEB-5242 - move code design comments into codebase