체인의정석

자바스크립트 주석 달기 (업데이트) 본문

개발/backend

자바스크립트 주석 달기 (업데이트)

체인의정석 2022. 11. 7. 10:53
728x90
반응형

이번에 이직을 하게 되면서 여러 팀원들과 함께 개발 내용을 공유할 상황이 되었다.

내가 담당한 부분은 많은 팀원들이 공통적으로 사용할 부분이기 때문에 주석을 한번 제대로 달아봐야지 하는 생각이 들었다.

 

https://developer.wordpress.org/coding-standards/inline-documentation-standards/javascript/

 

WordPress Developer Resources | Official WordPress Developer Resources

Official WordPress developer resources including a code reference, handbooks (for APIs, plugin and theme development, block editor), and more.

developer.wordpress.org

위의 글이 좀 잘 나와있는것 같앗다.

https://blog.bitsrc.io/best-practices-for-using-comments-in-javascript-4c4cd8619c18

 

Best Practices For Using Comments In JavaScript

How to Use Comments Efficiently in JavaScript

blog.bitsrc.io

 

일단 이번에 쓴 내용은 

1. @description : 내가 작성한 클래스나 함수에 대한 설명

2. // 정의한 클래스 내부의 요소들에 대한 주석

 

이렇게 2개이다.

 

http://www.gisdeveloper.co.kr/?p=6340 

 

개발성 향상을 위한 JavaScript의 주석 – GIS Developer

JavaScript는 type이 불명확하므로 문서화를 통해 그 상세정보를 남겨야 합니다. 그러나 소스코드와 분리된 문서는 사실상 그 활용가치가 매우 떨어집니다. 소스코드와 일원화된 방식으로 문서화가

www.gisdeveloper.co.kr

자바스크립트에서 주석을 달때 

 

@param{""|""|}

이런식으로 하면 파라미터에 대한 타입을 잘 서명할 수 있다.

 

 

728x90
반응형
Comments