Осторожно: документация по MikroTik!

Очень аккуратно относитесь к любым источникам информации по MikroTik. Любым — это любым дословно. В том числе и к официальным.
Хотите научиться работать с MikroTik? В этом поможет углубленный курс по администрированию MikroTik. Получите демо-доступ к этому курсу бесплатно.
Если это еще и неофициальный источник информации, то доверие к нему должно упасть до уровня ниже плинтуса. Проблема в том, что статьи зачастую выглядят очень умными, а заявления на форумах выглядят крайне безапелляционными. Не надо вестись на это. Помните, что раньше в России были две проблемы: дураки и дороги. Последнее время к этим двум проблемам добавилась третья — люди, которые любят высказывать свое экспертное мнение по вопросам, в которых не разбираются.

Официальные источники информации

В настоящее время существует два таких сайта: https://help.mikrotik.com/docs/ и https://wiki.mikrotik.com.
1-й (help) — это более новый официальный сайт с документацией. В настоящее время происходит переезд со второго (wiki) на первый (help). Соответственно, в первую очередь информацию надо искать на help’е, и если ее там нет, то уже на wiki. Если вы видите противоречивую информацию между help и wiki, то это значит, что вы не послушались рекомендации, что вначале надо искать на help’е. Но если вы уже нашли противоречивую информацию, то более корректной надо считать информацию с help’а. Если на help’е информации нет, то только тогда ищите на wiki. Недостаток этих сайтов в том, что информация только на английском языке.

Как оценить информацию из официального источника?

Как я уже сказал, с определенной долей недоверия надо относиться даже к официальным источникам информации. Во-первых, они могут содержать ошибки, а во-вторых, надо понимать, что эти источники не являются всеобъемлющими и в них содержится далеко не весь объем информации.
Приведу ряд примеров:
1
В описании Packet Flow было полностью неверно описано прохождение трафика в Input. Я описал это в заявке SUP-5380, и вендор подтвердил неверное описание и исправил его.
Packet Flow
SUP-53580
2
В описании принципа работы протокола RSTP была ошибка. Я описал это в заявке SUP-10 616. Вместе с техподдержкой за несколько проходов мы исправили ошибки (скриншот 2. Ошибка в описании принципа работы RSTP).
3
Бывает, что не хватает каких-то нюансов, которые могут исправить или дописать на основании заявки в ТП.
В целом мой посыл не в том, что официальная документация плохая. Она хорошая, и я лично ею регулярно пользуюсь. Посыл в том, что:
  • Надо свою голову на плечах иметь и самому тоже думать.
  • У вендора работают такие же живые люди, как и мы с вами, и они так же могут ошибаться.
  • Вендор идет на контакт, если давать обоснование своей точки зрения.

Вики по MikroTik на русском

В этой части я расскажу про сайт mikrotik.wiki. В отношении этого сайта я могу быть не совсем объективным, так как за его наполнение отвечаю я. Но я очень постараюсь дать непредвзятую оценку.
Условно сайт сейчас можно разбирать на две части: страницы с карточками оборудования и страницы с описаниями настроек. Сначала про карточки оборудования. Первая мысль — зачем смотреть куда-то не туда, когда можно смотреть туда (на официальный сайт). Попробую рассказать зачем.
1
Информация на русском языке.
2
Посмотрите, например, на страницу маршрутизатора RB2011iL-IN на mikrotik.wiki и на официальном сайте. И найдите на обоих сайтах информацию о размерах (Dimensions на английском) оборудования. Тут вы должны сказать: «Ага, попался! Неверная информация на mikrotik.wiki». Потом выдохните и посмотрите официальную брошюру этой же модели. Кстати, ссылка на нее есть на официальной странице на вкладке Support & Downloads. А как же было определено, какое из значений правильное? За наполнение сайта и проверку достоверности размещенной на нем информации отвечают несколько разных людей. Первым делом мы смотрим ТОЛЬКО официальные источники информации и сверяем их на предмет противоречий. Далее формируется список, и эти противоречия я отправляю вендору. Вендор мне отвечает с указанием реальных правильных параметров и берет эту информацию себе на заметку. Но, как правило, я такую информацию успеваю отобразить вперед вендора. Сейчас заявка с маленьким списком разночтений. «Всего» четыре страницы. Когда ответят на эту заявку, сразу отправлю следующий список. Он у меня уже готов.
3
Как я уже упомянул, за наполнение сайта отвечают несколько людей. После того как информация размещается на mikrotik.wiki, ее независимо друг от друга проверяют несколько людей. И проверяют очень дотошно, а не для галочки.
4
Формально mikrotik.wiki содержит ту же самую информацию, что и в официальных источниках. Но! Большой объем этой информации надо либо искать на разных страницах официальных сайтов, либо она явным образом отсутствует и известна тем, кто «в теме». Приведу примеры:
  • Блок возможности свитч-чипа содержит информацию, которая получена в два этапа. Сначала в официальной карточке оборудования ищется модель свитч-чипа. Далее в официальной документации ищется информация по этому свитч-чипу. Иногда ищется на нескольких разных страницах. И в итоге это сводится все на одной странице mikrotik.wiki.
  • Блок поддержка VLAN не содержит никакой секретной информации. Проблема в том, что эту информации знают посвященные и явным образом ее нет. Она есть, но в косвенном виде.
Хотите научиться работать с MikroTik? В этом поможет углубленный курс по администрированию MikroTik. Получите демо-доступ к этому курсу бесплатно.