Почему ваш технический контент не работает (И как это исправить)
Тихая смерть технического контента Вы знаете этот момент, когда вы натыкаетесь на страницу документации, начинаете читать, и уже к третьему абзацу ваши глаза стекленеют? Вы не одиноки. Где-то в канале Slack прямо сейчас разработчик печатает: «Кто-нибудь читал эту документацию? Я так запутался». Суровая правда: большинство технических материалов не работает не потому, что они неверны, а потому, что забывают, что их будут читать люди — реальные, уставшие, нетерпеливые люди. Мы пишем так, как будто роботы объясняют физику другим роботам, вместо того чтобы преодолеть разрыв между «я это глубоко понимаю» и «я могу объяснить это тому, кто не понимает»....