История изменений

В рекомендации стоит добавить пункты: «Не забывайте упоминать о том, что есть и другие способы делать то же самое. Так же указывайте, что этот способ работает только в таких-то средах».

Частая проблема начинающих — они не привыкли к тому, что у одной и той же задачи может быть десяток решений. Поэтому они могут не понимать, что ту же раздачу WiFi можно настроить разными способами, и гайды по одному способу не подходят для решения проблем, которые возникли при следовании другому.

А в плохих инструкциях обычно всё преподносится как единственно правильный и возможный вариант. Нередко даже забывают упомянуть, что это работает не везде.

Поэтому новички могут пытаться настроить сеть в CentOS через /etc/network/interfaces или поменять тему значков в KDE по гайду для GNOME.

Да, такая документация длиннее и скучнее, но иначе — она плоха. А у тебя на сайте ощутимо превалирование количества над качеством.

В рекомендации стоит добавить пункты: «Не забывайте упоминать о том, что есть и другие способы делать то же самое. Так же указывайте, что этот способ работает только в таких-то средах».

Частая проблема начинающих — они не привыкли к тому, что у одной и той же задачи может быть десяток решений. Поэтому они могут не понимать, что ту же раздачу WiFi можно настроить разными способами, и гайды по одному способу не подходят для решения проблем, которые возникли при следовании другому.

А в плохих инструкциях обычно всё преподноситься как единственно правильный и возможный вариант. Нередко даже забывают упомянуть, что это работает не везде.

Поэтому новички могут пытаться настроить сеть в CentOS через /etc/network/interfaces или поменять тему значков в KDE по гайду для GNOME.

Да, такая документация длиннее и скучнее, но иначе — она плоха. А у тебя на сайте ощутимо превалирование количества над качеством.