better naming and some comments for portlet stuff