투표 주석 논쟁

2023.05.23 | 조회수 1,572

alter

A: 주석을 좀 다는게 어떨까? 그래야 신규 직원 채용해도 수월할듯 B: ㅇㅇ 동의함 어떻게 작성할까 A: // 카트 추가 // productIds: 상품 번호 목록 fun addCart(productIds: [Int]) B: 이거 그냥 함수명, 매개변수명 그대로 한글로 쓴거 아님? 이럴거면 차라리 안 쓰는게 나을듯. 그냥 코드 선언부만 읽어도 이해되자나 A: 그래도 있어야함. 주석 없으면 신규 입사자 어려움 B: 저런 주석이면 여기는 cart가 뭔지 몰라서 주석으로 다나 싶어서 도망갈듯

주석 논쟁

투표 종료

총 366명 참여

선언부 그대로 한글로 적더라도 주석

126(34%)

저럴거면 그냥 네이밍을 더 열심히해

240(66%)

닉네임으로 등록

등록

전체 댓글 16

피곤한 개발자

2023.05.24

BEST윗분들 말씀대로 주석은 간단히 남기는게 맞는데 헤당 함수를 왜 추가하는지가 들어가는게 더 좋습니다. 위의 예라면 의미없지만 뭔가 요구사항 등으로 새로 만든 함수같은 경우 말이죠. 그래야 몇달뒤에 자기가 개발한 소스도 왜 개발했지? 하는 상황이 적어지더군요.

리멤버 회원이 되면 16개의 모든 댓글을 보실 수 있습니다

로그인

회원가입

김커뮤니티

2020.07.01

BEST회사에서 풀지 못한 고민, 여기서 회사에서 업무를 하다가 풀지 못한 실무적인 어려움, 사업적인 도움이 필요한 적이 있으셨나요? <리멤버 커뮤니티>는 회원님과 같은 일을 하는 사람들과 이러한 고민을 해결할 수 있는 온라인 공간입니다. 회원 가입 하고 보다 쉽게 같은 일 하는 사람들과 소통하세요

154

김커리어

2020.07.01

BEST리멤버 회원을 위한 경력 관리 서비스, 리멤버 커리어를 소개합니다. 당장 이직 생각이 없어도, 좋은 커리어 제안은 받아보고 싶지 않으신가요? <리멤버 커리어>는 리멤버에서 새롭게 출시한 회원님들을 위한 경력 관리 서비스 입니다. 능력있는 경력직 분들이 <리멤버 커리어>에 간단한 프로필만 등록해두면, 좋은 커리어 제안을 받아 볼 수 있습니다. 단 1분의 투자로 프로필을 등록해두기만 하면, 기업인사팀이나 헤드헌터가 회원님께 꼭 맞는 제안을 직접 보내드립니다. 지금 바로 <리멤버 커리어>에 프로필을 등록하고, 새로운 기회를 만나보세요!