🚀🚀
ну и что?
ну не наезжай)
Size: a a a
2020 October 02
ф
тут algolia, кто пробовал поиск в доке бабеля и реакта в курсе как она работает
и вебпака 🌚
🚀🚀
да, такие ситуации тоже уже были. но так же был ряд людей, которых испугала дока createStoreObject, а количество методов в апи негативно влияет вообще на всех
^
c
есть люди, которые не увидев метод на главной странице, уйдут с сайта читать типы
V
ну и что?
ну, мы же хотим доступности, а не отписываться из серии "не нашел - твои проблемы"
🚀🚀
люди теряются на каждом этапе
🚀🚀
лендинг доки, давайте прямо, говно
c
ну, мы же хотим доступности, а не отписываться из серии "не нашел - твои проблемы"
какое предложение? добавить статью с одной строчкой?
🚀🚀
сегодня пофиксил руководство по тайпскрипту в котором сторы с большой буквы
🚀🚀
недавно исправляли жесткие баги в описании основных методов
V
какое предложение? добавить статью с одной строчкой?
иметь это в доке, но явно указывать что
deprecated🚀🚀
core concepts только недавно стал хотя бы понятным. а это третья по счёту страница доки!
🚀🚀
проблем огромное количество, люди отваливаются на каждом шагу, и имея ограниченные ресурсы, приходится выбирать, какую долю пользователей хочется сохранить сейчас, а какую — завтра
c
иметь это в доке, но явно указывать что
deprecatedмб лучше создать внизу раздел migration guide
в который и добавить этот метод и показать как переехать с него
и в глаза не будет бросаться и через ⌃+f найдется
в который и добавить этот метод и показать как переехать с него
и в глаза не будет бросаться и через ⌃+f найдется
🚀🚀
обрати внимание на тот факт, что количество методов в документации резко негативно влияет на впечатление от доки
🚀🚀
это не вопрос сделать хорошо или не сделать
🚀🚀
это вопрос «после какого решения будет меньше всего последствий»
c
обрати внимание на тот факт, что количество методов в документации резко негативно влияет на впечатление от доки
можно не размещать этот метод в основном списке методов
тогда он и не будет привлекать внимание
тогда он и не будет привлекать внимание
🚀🚀
так и сделано
🚀🚀
что выбрать, по немногу испортить впечатление всем или сильно испортить впечатление некоторым?