JsDocs update and code review for consistency