React собирается переписать документацию
Vueа такжеReact, Кто является лучшим выбором, этот спор, кажется, никогда не прекращается. Но в одном вопросе фанаты с обеих сторон, похоже, пришли к редкому соглашению:
Документация Vue намного лучше, чем документация React.
ReactОбъяснение разработчика этому:VueОн был разработан китайцами, и написанные документы, конечно, больше соответствуют чтению китайцев.
но от#3308С точки зрения, кажется, что глобальнаяReactРазработчики долгое время боролись с документацией. так что в этом вопросеReact Core TeamЧлен rachelnabors сказал со слезами на глазах:
«Чтобы компенсировать отсутствие официальной документации, разработчики-энтузиасты сделали многоReactруководство. Как мы желаем от вас написать первымReactОт начала компонента до конца вашей карьеры официальный документ — это единственный «он», который рядом с вами».
вместе сHooksПризнание растет, но существующая документацияClassComponentрасширенный,HooksПросто отдельная глава.
Поэтому,ReactКоманда решила переписать документацию.
Основная причина, по которой документацию React трудно понять
Действительно ли разница между документами только потому, что «документы, написанные китайцами, больше подходят для китайцев»? Очевидно нет.
Чтобы понять различия в документах, нужно поговорить о различиях во фреймворках.
VueНа основе разработки «языка шаблонов» степень абстракции выше. По сути, его документация представляет собой введение в синтаксис «языка шаблонов».
Затем просто запомните необходимую грамматику.
а такжеReactМенее абстрактное, прямое использованиеJS(JSXпросто синтаксический сахар).
в сравнении сVueГрамматика поддерживает это,ReactТребуется много времени, чтобы объяснить, как различные потоки данных и шаблоны проектирования работают вReactиспользуется в.
Разве вы не видите, что для решения проблемы повторного использования компонентовReactимеютHOC,render props,组合模式и многие другие понятия.
На этот раз будет сложно.
Что изменилось в новом документе
Зная суть проблемы, посмотрим, какие изменения будут внесены в новую документацию.
- к
Hooksиспользуется во всем документе
больше никогдаClassComponentНапример, это также показываетHooksСтав стандартом разработки де-факто, он получил признание сообщества.
- «Объяснение терминов и понятий» для начинающих программистов.
React,включатьReduxМне это очень нравится (модифицированное, мне очень нравится) с использованием различных теорий и концепций, которыми я руководствуюсь в своей работе (например,代数效应кHooks).
Это заставляет многих фронтендов восхищаться «высоким» и причитать «не могу понять».
С этой целью в новый документ будут добавлены пояснения многих терминов и понятий.
- Дополнительные примеры диаграмм, онлайн-демонстрация, интеграция
Dev-toolsа такжеlint.
Иллюстрации просты для понимания, простая онлайн-демонстрация для изучения во время практики. Двусторонний подход, с благими намерениями.
Причем на этот раз новый документ написал лично Дэн Абрамов. Лучшие интернет-знаменитости в классе передовых интерфейсов находятся в движении, и уровень внимания очевиден.
когда ты сможешь увидеть
Он так хорошо пахнет, когда я его увижу? Официальный ответ: в начале 2021 года.
Текущая версия документа будет заархивирована, и новая версия документа не будет изменена на основе текущей версии документа.
Если вы не можете ждать, официальныйДокументация текущей версии на основе хуковУтолить свою тягу.