Когда ты в последний раз читал документацию по технологии блокчейн и не сходил с ума, сколько времени прошло с тех пор?
Документация большинства цепочек, как «Криптомазе»: открываешь экран, заполненный терминологией, чтобы найти учебник по развертыванию, нужно пройти 5 уровней меню, еле-еле увидел пример кода, копировал и вставил, но возникла ошибка — в итоге только с полным недоумением отправляюсь в Discord как «помощник».
Но документация Linea на docs.linea.build превращает «чтение документации» в удовольствие, как просмотр учебных видео. Она не рассматривает документацию как «техническое руководство», а воспринимает ее как «интерфейс продукта», который ведет диалог с пользователем, от скорости загрузки до дизайна содержания, каждая деталь говорит: «Я понимаю твою проблему, я помогу тебе решить её.»
В момент открытия страницы вы заметите, что она отличается:
Загрузка так быстра, что вы «подумаете, что не нажали»: CDN обеспечивает глобальное ускорение, даже в условиях средних сетей страницы документации открываются за секунды, вам не нужно смотреть на пустой экран, ожидая загрузки;
Навигация как «умный гид»: без «коктейля из всего на свете» в каталоге, прямо по ролям «разработчик / обычный пользователь / сторона экосистемного протокола» — хотите перевести ETH? Нажмите «Руководство пользователя», чтобы за 3 шага найти руководство; разработчик хочет развернуть контракт? В «инструментах разработчика» есть все от настройки окружения до примеров кода, не нужно тратить время на нерелевантный контент;
Многоязычность как «внимательный переводчик»: по умолчанию поддерживает двуязычный китайско-английский режим, даже сообщения об ошибках локализованы, вам больше не нужно гадать, является ли «недействительная подпись» ошибкой в закрытом ключе или в неправильном выборе цепочки.
Более того, она превратила «статическую документацию» в «интерактивную лабораторию»:
Под каждым API интерфейсом есть кнопка «Попробовать» — не нужно устанавливать локальную среду, просто укажите параметры в документации, нажмите тест, и результаты будут показываться в реальном времени, даже ошибки сопровождаются «ссылкой на решение». Например, если вы заполнили неправильный адрес актива при вызове API моста, документация не только укажет «неверный формат», но и перенаправит вас на «инструмент проверки адресов активов», чтобы помочь вам быстро найти правильный адрес.
Для новичков «дизайн учебного пути» является жизненной необходимостью:
Нажмите «Начать», чтобы сразу перейти в «режим пошагового обучения»:
Первый шаг «установка кошелька»: не только предоставлен ссылка на скачивание MetaMask, но также приложена анимация «как переключиться на сеть Linea», даже «что делать, если я забыл резервную фразу» заранее написано в примечаниях;
Второй шаг «мостовой ETH»: каждое действие по переводу с основной сети на Linea выделено красным цветом, также сопоставлены плюсы и минусы «официального моста против третьестороннего моста», чтобы помочь вам избежать подводных камней;
Третий шаг «развертывание контракта»: встроенный онлайн IDE, полный код Solidity, просто нажмите «Запустить», чтобы увидеть прогресс развертывания контракта, а после успеха вас обучат «как проверить статус контракта в обозревателе блоков»;
На протяжении всего процесса нет пропущенных шагов «вы должны знать», даже самые страшные для новичков «настройки окружения» решены, как будто рядом с вами стоит технический гуру, обучающий вас шаг за шагом.
Даже «встретив проблему», вы уже заранее обдумали план действий:
Внизу каждой страницы встроен «модуль взаимодействия с сообществом» — если вы все еще не понимаете документацию, нажмите на иконку Discord, чтобы сразу перейти в соответствующий канал обсуждения, где уже другие разработчики поделились решениями схожих проблем; в ссылке Reddit также есть «ключевые заметки по документации», которые помогут вам сэкономить время.
Один новичок Web3 сказал на форуме: «Ранее, смотря документацию других цепочек, я через полчаса хотел сдаться; теперь, читая документацию Linea, я незаметно прошел процесс ‘развертывания DApp с 0 до 1’, даже следуя рекомендациям по оптимизации в документации, я снизил Gas на 20% — это первый раз, когда я понял, что техническая документация также может ‘помочь на практике’».
За этим стоит то, как Linea делает «документальный опыт» центральным элементом продукта:
Они специально пригласили команду UX-копирайтеров уровня Stripe, чтобы сложные концепции, такие как «процесс проверки ZK-SNARKs», были разбиты на простые объяснения, например, «это как будто вы ставите зашифрованную печать на транзакцию, основная сеть только проверяет печать, не смотря на содержание»; опираясь на «проблемно-ориентированную» логику документации Vercel, они поместили «как решить проблему неудачного развертывания контракта» на самое заметное место в «руководстве по развертыванию», а не спрятали это в «часто задаваемых вопросах».
В Web3 индустрии многие проекты рассматривают документацию как «приложение к выполнению задачи», заполненное «правильными банальностями»; но Linea считает документацию «первым окном для пользователей в экосистему» — когда цепочка так заботливо «учит вас, как ее использовать», вы должны понимать: она может привлечь 420 экосистемных проектов и 1,3 миллиона пользователей, и это никогда не случайно.
В конце концов, если «неприятные дела» могут быть сделаны комфортно, значит, вы действительно понимаете пользователей.
