​​📄Собрать сервер как LEGO: открываем динамическую документацию

Представьте себя на месте сборщика сервера с тысячей возможных конфигураций. Вы стоите у конвейера, лихо подтягиваете к себе увесистый лоток с россыпью деталей — предварительно набранных в соответствии с одной из этих конфигураций. А с какой конкретно? Это вам подскажет полная инструкция к сборке сервера, которая весит как пол-лотка с деталями. На всё про всё у вас 40 минут, удачи.

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

Альтернативное решение разработал отдел производственной документации YADRO. В новой статье вы узнаете:

▪В чём преимущества и недостатки общих инструкций для сборки;
▪Почему невозможно писать отдельные инструкции для сборки каждой конфигурации;
▪Какие преимущества даёт подход динамической документации;
▪Как реализовать этот подход в своей компании.

Читать статью ➡

#инженернаякультура #документация

@ultimate_engineer