2022-11-22

Эталоном документации по продукту для меня является Maintenance Manual на большие системы хранения данных Hitachi Data Systems. Эта документация написана с фантастической точностью и подробностью. Если система поддерживает установку до 4 тысяч дисков, то в руководстве будет описана процедура добавления каждой RAID группы, сколько и каких групп можно создать, в какие слоты диски можно ставить и в какие RAID объединять. Наличие такого подробного руководства отчасти призвано решить проблему с излишне сложным, не подвластным простой человеческой логике интерфейсом администрирования и отсутствия “Plug and Play@ как такового в ранних моделях.

Эту систему можно сломать только одним способом - если не следовать мануалу. Чего стоят только эти изометрические схемы. Мне каждый раз приходится по три минуты на них смотреть чтобы понять с какого ракурса это изображено.

Еще в данном комплекте документации мне очень нравятся блок-схемы устранения неисправностей. В одном своем проекте я даже попытался реализовать нечто подобное.

Конечно я не смог повторить всей точности и подробности оригинальных схем, но дать общее понимание принципа действий в определенной ситуации кажется смог.

В заключении хочу сказать что при подготовке документации я всегда стараюсь держать в уме мысль “как бы это выглядело, если бы оно было описано в Hitachi VSP Maintenance Manual” и балансировать между желанием расписать каждый чекбокс, снять снимок каждого диалогового окна и врожденной непреодолимой ленью .