update inline comments for better documentation