Я знаю, что есть разные варианты JSDoc. И кажется, что каждая реализация парсера JSDoc распознает свой собственный набор тегов. Например, рассмотрим различия в тегах междуhttp://usejsdoc.org/иhttp://www.techrepublic.com/blog/programming-and-development/create-useful-relevant-javascript-documentation-with-jsdoc/451.
В этот момент я просто в замешательстве. Существует ли каноническая реализация JSDoc или общепризнанный набор основных тегов? Существует ли лучшая реализация JSDoc?
РЕДАКТИРОВАТЬ
Как сказано в комментарии ниже, причина этого вопроса в том, что мне нужно проанализировать комментарии JSDoc для использования с инструментом, который мы создаем. См. этот вопрос»:Есть ли парсер JSDoc с открытым исходным кодом, написанный на Javascript?
Я обеспокоен тем, что мне придется свернуть свой собственный синтаксический анализатор, и если я это сделаю, мне нужно знать, какие теги должны поддерживаться.
Но на более глубоком уровне меня беспокоит отсутствие согласованной спецификации (или эталонной реализации ). Из-за этого JSDoc кажется мне немного случайным.