Size: a a a

JavaScript fwdays

2021 June 05

EO

Eugene Obrezkov in JavaScript fwdays
Да, те же, но в случае с JSDoc никто не проверяет, что он не «протух». В итоге через полгода-год у вас устаревшая документация и по факту там вообще не то, что написано в JSDoc.

В случае с тайпскрипт, эта «документация» это типы, которые всегда проверяются компилятором.

В идеале, комбинировать TS и TSDoc, а в TSDoc делать код блоки с примерами пользования. Во время билда, так же запускать и эти примеры как часть тестов.

Тогда у вас будут и типы, и документация для пользователей, которая ещё и тесты в себе дополнительные несёт, что документация не устарела.

Мне очень нравится как это реализовано в Rust
источник

J

Julia in JavaScript fwdays
проблемы с трансляцией
источник

ES

Elena Sharovar in JavaScript fwdays
Ну вот поэтому мне ts и нравится: он дает читабельность и понятность типов, и не нужно следить что не протухли описания как с jsdoc-ом
источник

AS

Andrii Shumada in JavaScript fwdays
так закінчилась конференція, тепер тільки spatial
источник

EO

Eugene Obrezkov in JavaScript fwdays
🤷‍♀️

У людей нету проблем с JavaScript и они не понимают какие проблемы решает TypeScript, пока масштабы команды и проекта не выходят за «определённый порог».
источник

EO

Eugene Obrezkov in JavaScript fwdays
И, ради справедливости, они правы. Если проекты небольшие, то использование того же TypeScript на нём может быть неоправданно.
источник

AV

Anton Verinov in JavaScript fwdays
В этом и проблема, закончившаяся конференция. Хотя Илья продолжает говорить в spatial, так что закончилась ли конференция на самом деле?
источник

AV

Anton Verinov in JavaScript fwdays
Спеки писать и ревьювить на маленьком проекте тоже как-то ehhhh 🙃
источник

J

Julia in JavaScript fwdays
На самом интересном😆 в любом случае огромное спасибо. Мне очень понравился ваш доклад👍
источник

I

Igor in JavaScript fwdays
Я с Ильей согласен в том плане что не всегда этот инструмент выбирается осознанно.
Ну а следить за тем что-бы JSDoc всегда был актуальным - это еще та задача.
источник

EO

Eugene Obrezkov in JavaScript fwdays
Каргокульты никто не отменял, конечно.

Выберу ли я TypeScript, для скриптов автоматизации билдов и деливери? Буду ли я заморачиваться, чтобы на CI было всё сложнее чем node build.js? Очевидно, нет.

Выберу ли я TypeScript, для написания своего рантайма или инструмента для кодогенерации кусков кода из прото файлов? Очевидно - да.
источник

AS

Andrii Shumada in JavaScript fwdays
<3
источник

AP

Andrii Pochekuiev in JavaScript fwdays
рефакторинг. Тайпскрипт там дает намного больше чем тесты
источник

AM

Andrey Melikhov in JavaScript fwdays
Но при этом рефакторинг без тестов невозможен
источник

AM

Andrey Melikhov in JavaScript fwdays
А без TS — возможен )
источник

AP

Andrii Pochekuiev in JavaScript fwdays
прям когда есть graphql приложение, где сигнатура меняется на недельной основе, то там тайпскрипт просто боженька
источник

AP

Andrii Pochekuiev in JavaScript fwdays
который сразу показывает где все поломалось
источник

AP

Andrii Pochekuiev in JavaScript fwdays
а тесты - не могут
источник

IV

Ievgen Vyshnevskyi in JavaScript fwdays
@d_goncharuk я хотел спросить, а будет ли какая-то страница по типу /raffle-partners-js21 где будут победители конкурсов? или надо самому проверять ? спасибо 😉
источник

IB

Iryna Bozhyk in JavaScript fwdays
Идея!
источник