почему ТС документирует поведение? Это скорее будут соглашения, то есть показать, что мы хотим там видеть, а в тесты каждый раз заходить и искать все места, где используется определенная функция, такое себе занятие.
Тем более, что тесты могут противопоставить IntelliSense'у? (JSDoc не предлагать)