Fix notices from code review: update doc blocks and use field_get_items instead of manual looping