meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
blog:2022:11:21 [2022/11/21 17:02] – created mchusblog:2022:11:21 [2022/11/26 09:25] (current) – ↷ Links adapted because of a move operation 172.68.11.77
Line 1: Line 1:
-====== 2022-11-21 ======+====== 2022-11-21 Еще раз о необходимости подготовки человеческих инструкций ====== 
 +По одному из проектов мне понадобилось подготовить инструкцию на санкционные серверы Lenovo SR650. Я вздохнул с облегчением и отложил эту задачу в долгий ящик. 
  
 +  * Во первых это не первый мой проект на серверах леново, еще недавно это был достаточно популярный производитель импортных серверов в России и мне удалось с ними поработать, поэтому кое-какие наработки в этом направлении у меня уже были.
 +  * Во вторых вендор импортный и фигни в инструкции не напишет, подумал я, темболее все руководства доступны на Русском языке на официальном сайте даже после введения санкций.
 +  * В третьих я решил что можно будет частично скопировать качественные мануалы производителя так как выполнены они наверняка на высшем уровне.
 +  * В четвертых я благополучно про эту задачу забыл.
 +
 +Уровень перевода документов сравним с великим тестом "Гуртовщики мыши". Для понимания написанного приходится "на лету" переводить обратно в английский.
 +
 +{{:blog:2022:11:21:20221121-230815.png}}
 +
 +Документация очень подробная и поэтому практически бесполезная в повседневном использовании, эта книга больше похожа на большую советскую энциклопедию, когда должна быть, по моему мнению журналом "Мурзилка.
 +
 +Никаких стоящих наработок у меня не оказалось, в виду того что стандарты документации по остальным компонентам подсистемы я задал таким образом что гайды которые были мною написаны несколько лет назад годятся теперь только лишь для одного абзаца.
 +
 +Идея со страницами-рубрикаторами для руководств администратора сейчас у меня в приоритете и такой формат подачи материала мне кажется более удобным чем "Книга" "все страницы в одной". Я немного переделал руководство по "[[domestic:yadro:guide:x2-x05:x2-205|Ядру]]" на манер того, как я подготовил "[[domestic:rosplatforma:guide:admin|Росплатформу]]". И по их образу и подобию сделал скелет для [[enterprise:lenovo:guide:think_system_sr650:admin_guide|SR650]].
 +
 +На выходе получается что сводный документ содержащий все разделы нужен лишь только мне для выгрузки подгтовленной документации для дальнейшей ей правки и подготовки к публикации в проект. Обычному пользователю и даже мне наверняка будет удобнее пользоваться рубрикатором.
 +Также в процессе эксплуатации я дополняю руководство дополнительными разделами которые не вошли и не войдут в руководства которые я делаю по проекту, но имеют большую пользу. Данные разделы теперь я тоже включают в рубрикатор и стараюсь найти им заслуженное место.
 +
 +Такими статьями например стали:
 +  * [[domestic:yadro:guide:x2-x05:storage:jbod_mode_on|Включение режима JBOD на сервере YADRO X2-205 / X2-105]]
 +  * [[domestic:yadro:guide:x2-x05:storage:raid_groups|Настройка RAID на сервере YADRO X2-205]]
 +  * [[domestic:rosplatforma:guide:download_virtuozzo_container_templates|Скачивание шаблонов контейнеров Virtuozzo]]
 +
 +Тем временем я пытаюсь достучаться до офисной лабы с серверами Lenovo чтобы снять скриншоты с XCC, так как в руководстве представлено минимум изображений и минимум смысла по каждой операции.