branch: rework comments for future developers