What is the preferred method of commenting JavaScript objects and methods? [closed]

Question

As it currently stands, this question is not a good fit for our Q&A format. We expect answers to be supported by facts, references, or expertise, but this question will likely solicit debate, arguments, polling, or extended discussion. If you feel that this question can be improved and possibly reopened, visit the help center for guidance. Closed 9 years ago. I'm used to Atlas where the preferred (from what I know) method is to use XML comments such as: ///

/// Method to calculate distance between two points ///

/// /// First point /// Second point /// function calculatePointDistance(pointA, pointB) { ... } Recently I've been looking into other third-party JavaScript libraries and I see syntax like: /* * some comment here * another comment here * ... */ function blahblah() { ... } As a bonus, are there API generators for JavaScript that could read the 'preferred' commenting style? JavaScript questions and answers, JavaScript questions pdf, JavaScript question bank, JavaScript questions and answers pdf, mcq on JavaScript pdf, JavaScript questions and solutions, JavaScript mcq Test , Interview JavaScript questions, JavaScript Questions for Interview, JavaScript MCQ (Multiple Choice Questions)

Answer 1

There's JSDoc /** * Shape is an abstract base class. It is defined simply * to have something to inherit from for geometric * subclasses * @constructor */ function Shape(color){ this.color = color; }