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

{{:blog:2022:11:22:20221122-225223.png}}

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

{{:blog:2022:11:22:20221122-225458.png}}

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

{{:blog:2022:11:22:20221122-225821.png}}

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

{{:blog:2022:11:рисунок1.png}}


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

----

{{:blog:2022:11:img_20170202_132622.jpg?600}}{{:blog:2022:11:img_20170130_191724.jpg?600}}{{:blog:2022:11:img_20170126_193130.jpg?600}}{{:blog:2022:11:img_20181120_152832.jpg?600}}