Комментарии по ссылке
 

1. Идея наверное не нова, но поделюсь, может кому будет интересно. В коде ставим метку, например (слова разные можно):

//*attantion

, а ниже в нужно месте пишем:

//см. *attantion

В простом коде подобное не нужно, но если проект большой, то может сильно облегчить жизнь.

Если кто-то ещё знает улучшители разбора понимания логики, то напишите.

2. Если кто не в курсе в Web(Php)Strom есть вкладка TODO. Очень полезная штука. Удобная навигация по всему проекту.

В JSDoc для этих задач есть @see, WS поддерживает.

Несовсем.

@see ссылается на переменную или на функцию, по ней можно ткнуть и попадешь в декларацию.

А если мне нужно сослаться на другую строку комментария расположенного ниже или выше или и там и там, то @see мне уже ничем не поможет.

А вот это не важно, т.к. иногда нужно просмотреть не в веб сторм и там это уже не работает в большинстве случаев.

Не обязательно, можно указывать что угодно, хоть гиперссылку, хоть номер строки.

Номер строки указать - плохая идея, это жесткая, абстрактная привязка, любое редактирование выше описания поломает связь.

/*description
 * тут подробное описание логики, никаких функций, методов и т.д. просто текст
 */

// см. *description <- тут создаем ссылку на описанный выше/ниже блок

Как реализовать подобное в jsDoc?