Всем привет.
Есть задача написания двух версий документации для кода: на английском и на русском. Ведение двух версий проекта и их синхронизация затруднительна. Я знаю, что такого нет из коробки в JSDoc, но, возможно, у кого-то есть идеи для хаков. Я представляю себе "язык", как дополнительный кастомный тег:
...
/**
@doclang rus
@method f
@desc Крутой метод
@doclang eng
@method f
@desc Awesome method
*/
f: function() { /* ... */},
...
Спасибо.
UPD
Я не зацикливаюсь на JSDoc, меня волнует только одно: как сделать документацию на двух языках, но не прописывать её в статичных HTML файлах, чтоб можно было легко изменить шаблон вывода: HTML, JSON или в другую форму. Дошло до того, что я задумался написать собственный движок документирования вне JS файлов.
<method name="f" class="ClassName" lang="en">
<sum>
This method is very cool
</sum>
<desc>
Big description
</desc>
<arguments>
<argument name="x" optional="optional" default="12">
Cool argument 1
</argument>
<argument name="y" repeatable="repeatable">
Cool argument 2
</argument>
</arguments>
<examples>
<example caption="Basic usage">
alert( new ClassName().f() )
</example>
</examples>
</method>
<method name="f" class="ClassName" lang="ru">
<sum>
Крутой метод
</sum>
<desc>
Большое описание
</desc>
<arguments>
<argument name="x" optional="optional" default="12">
Крутой аргумент 1
</argument>
<argument name="y" repeatable="repeatable">
Крутой аргумент 2
</argument>
</arguments>
<examples>
<example caption="Базовое использование">
alert( new ClassName().f() )
</example>
</examples>
</method>
Но XML очень избыточный язык, а JSON - бедный. Что делать, хз пока.
