a
🤷♂️
Size: a a a
2020 June 09
SB
В общем, если кому-то интересно, то я решил проблему. Причину не скажу, т.к. я просто переписал атом заново и заработало 😂 Все равно спасибо за помощь)
Часто такое бывает, когда TS не используется :)
SB
Часто такое бывает, когда TS не используется :)
Сам в legacy коде сейчас натыкаюсь на подобные кейсы
AM
ну да, кстати, ts не задействован
SB
ну да, кстати, ts не задействован
Повод задуматься над его использованием :) Я уже год как не нарадуюсь. Часто помогает при различных опечатках и рефакторинге.
SB
Тем более в reatom очень классно вывод типов организован
AM
Да я сам за ts!) Просто на проекте, где задействовал reatom уже все react компоненты до меня написали на js. Не хватало только толкового state менеджера
🐏G
Тс невероятно помогает, если не халтурить в типах и поменьше any
MK
Тс невероятно помогает, если не халтурить в типах и поменьше any
И если не юзать либы, которые выводят any
2020 June 10
IN
@artalar Артём, так что, какой формат доки выбираешь?
a
Ivan Niemtinov
@artalar Артём, так что, какой формат доки выбираешь?
Я извиняюсь, но мне нужно еще время все это осилить и хорошо обдумать
IN
@artalar Понимаю. Основная разница в том, что в случае с имеющейся темой .md мы все описания методов берём исключительно из комментариев tsdoc, но зато можно делать эти комменты в любом формате (это и недостаток, потому что этот формат нельзя никак контролировать тулзами, можно лишь регламентировать). Тема .html - стандартная, по умолчанию. Хороша тем, что там всё по умолчанию и не нужен форк плагина с темой .md.
Я за первый вариант, потому что он позволяет с минимальными затратами эту инфраструктуру начать юзать.
И к сожалению, я в ближайшие месяцы не смогу докой заниматься, переключаюсь на другой проект (без reatom).
Я за первый вариант, потому что он позволяет с минимальными затратами эту инфраструктуру начать юзать.
И к сожалению, я в ближайшие месяцы не смогу докой заниматься, переключаюсь на другой проект (без reatom).
И
Не смотрел, но мне кажется что дергать из комментов уже не современно и сложнее для новой либы в продвижении
И
Те современнее сайт с примерами и playground прямо на странице и примерами кода для простых и сложных кейсов, разбитое на категории/функционал
И
Это можно сделать через mdx
И
Попробуй опиши и пойми через комменты перегруженный 7 раз метод, а с примерами это будет ясно.
И
Кому нужны будут подробности полезут в dts или исходники
И
Некий storybook только в виде сайта и другая компоновка
IN
@dkdfdz Ну посмотреть-то никто не мешает. Если не дёргать из комментов, то как добиться того, чтобы был единственный источник правды - исходник?
И в комментах примеры можно запихнуть (в некоторых местах - уже запихнуты. Не очень здорово, согласен.
Я в любом случае другой вариант делать не берусь.
Я уверен, что такие доки лучше, чем то, что есть сейчас. Если кто-то ещё возьмётся сделать другую инфраструктуру потом - это будет проще сделать.
Оно совсем не идеально, но хотя бы позволит постепенно улучшать доки - проще, чем было до этого PR.
https://github.com/artalar/reatom/pull/340
И в комментах примеры можно запихнуть (в некоторых местах - уже запихнуты. Не очень здорово, согласен.
Я в любом случае другой вариант делать не берусь.
Я уверен, что такие доки лучше, чем то, что есть сейчас. Если кто-то ещё возьмётся сделать другую инфраструктуру потом - это будет проще сделать.
Оно совсем не идеально, но хотя бы позволит постепенно улучшать доки - проще, чем было до этого PR.
https://github.com/artalar/reatom/pull/340
И
Труд большой проделан я просто идею высказал