어떤 설명서 형식이 JavaScript에 더 좋을까요?

Question

HTML 문서를 생성하는이 형식의 JavaScript 및 프로세서에 대한 설명 문서 형식이 있습니까?

현재 개발 시간에 IntelliSense 도움말을 제공하기 위해 VSDoc XML 주석을 사용하고 있지만 이러한 주석을위한 문서 생성기는 없습니다. 그래서 내 질문에 다음과 같이 들릴 수도 있습니다. VSDoc 주석을 JavaScript 파일에서 HTML로 변환하는 유틸리티가 있습니까?

Answer 1

JavaDoc 또는 VSDoc 또는 JSDoc 또는 이와 유사한 것으로부터 자동 생성 문서를 보았습니까?

그들은 모두 추악하고 읽을 수 없습니다.

이 솔루션은

• annotate your code with docco
• 이 당신의 API 문서를 손으로 작성 확인 두 배입니다.

우리가 자동으로 생성 한 문서 작성 방법에 혁명을 일으키는 세 번째 옵션이 있습니다.

Answer 2

몇 가지 프로젝트에 Natural Docs을 사용했습니다. 구문은 인라인을 읽는 데는 좋지만 JavaScript에 대해서는 "전체 언어 지원"이 없으므로 문서화하려는 각 함수/상수/클래스 /에 대해 명시 적으로 명시해야합니다. 같은 의견에서 VS 인텔리을 얻고 출력을 원하는 포맷 할 수 AjaxDoc

그 방법 : 자바 스크립트 파일을 구문 분석과 같은 XML 형식 NDoc 및 샌드캐슬 사용을 출력하는 유틸리티가있다

Answer 3

.