Мы исправили нашу документацию с помощью фреймворка Diátaxis.
Диатаксис недавно сделал первая страница HN. Я упомянул в комментарии, что мы применили эту структуру к блесток пару недель назад и были очень довольны этим. Некоторые люди просили меня расширить мой комментарий, поэтому я делаю это здесь: Ошибка в документации инженера Инженеры часто подходят к документации наоборот. Мы, конечно, сделали. Инженеру хочется все объяснить заранее. … Read more