Могу сказать свое мнение, но помочь не могу)
все равно доки никто не читает)
Я уверен, что есть пакеты, которые из TS-кода создают бездушные файлы, где просто прописано, что на входе и что на выходе. А нахрена оно нужно - не прописано. Так я и без документации это глянуть могу.  
Это нужна железная дисциплина, чтобы еще комменты писали или JSDoc-и.

Лично я писал бы документацию ручками с нуля именно по непонятным моментам.

Надеюсь, кто-нибудь подскажет что-нибудь дельное.

а исходники почитать не? совсем другое

Ctrl c + ctrl v = done

Спасибо)
Согласен, что доки с банальным парсингом сигнатур имеют мало полезного и поэтому их никто и не читает) Но почему то только такие примеры и находятся, причем не только в ноде или ts, поэтому собственно и задал вопрос. По мне так проблема достаточно важная, какому-нибудь открытому проекту умереть без нормальной доки как раз плюнуть, а писать ее отдельно сильно муторно(

Нормальная практика - писать *.md файлы с документацией (если для человеков, а не генерировать)

Что другое? Реализация? Так же абстракция функции обёрнута в поток, потоки так же менеджерятся балансером.

Да и вообще, учитывая то что каждый воркер по сути имеет собственный изолят v8 со стеком и кучей, свой цикл событий с очередью микротасков и прочим зоопарком, то такие потоки, в отличие от гошных, уж никак нельзя назвать легковесными.

Есть тесты, статистика, метрики показывающие это - в студию =) мы вместе посмотрим все _)что-то подсказывает что нету =)

Да о чём вы вообще говорите? Понимаете сами? Какая статистика? Метрики? Откуда вы вообще это всё берёте? Вам про гусей, вы про свиней. Тут без метрики понятно, что js код исполняется виртуальной машиной, одна и та же виртуальная машина не может его исполнять одновременно несколько стеков. Поэтому на каждый поток выделяется свой изолированный инстанс виртуальной машины, помимо виртуальной машины есть ещё инфраструктура обслуживающая её. Каждый инстанс это не 2 килобайта в памяти, как у go рутин, а куда больше. Какая статистка и метрика тут ещё нужна, когда только на этом этапе очевидно всё

Вы слишком много текста пишите давайте на конкретном примере будем говорить одна и таже задача на гоу и ноде с горутинами и этой либой _)

Я текста пишу ровно столько, чтобы у вас хоть какое-то осознание очевидных вещей было, но видать вам и этого мало. Раз продолжаете свой абсурд.

Ясно ну ок

Вы ведёте свою дискуссию крайне непрофессионально

Да тон, конечно резок. Извиняюсь за подачу. Вам Илья тоже нужны метрики, или мои умозаключения неверны?

Есть нюансы (с). Напрямую зависящие от того какие метрики нам важны

Вот прямо сейчас у меня сервер на uwebsockets + нода позволил сократить пул серверов компании на 15%. Хотя все выли что нода тормозная, го рулит

Поэтому "есть нюансы (с)". Рассуждать про обобщенные задачи легко :)

Так в том и дело, что уже требуются непонятно какие метрики. Хотя я указывал на то что есть базовая разница между го рутинами и потоками в ноде просто на уровне алокации памяти под инстанс изолята vm

там тоже всё лучше чем вам кажется, благодаря CoW

не 2 килобайта конечно как у горутины, но тем не менее