Size: a a a

technicalwriters

2020 October 05

ДЧ

Дарья Чернавина... in technicalwriters
Jaroslaw Martinow
У меня есть то же самое, только в стихах 😆

Всегда найдутся хрюшкины копыта
Четыре ножки, щетиной покрытых
Что роют землю под кудрявыми дубами
Чтобы полакомилась Хрюшка желудями


Всегда найдётся шёлковая грива
Которой Лошадь дрыгает игриво
Подпрыгивает, бегает и ржёт
И сочную траву в полях грызёт


Всегда найдутся острые колючки
К которым липнут листья как к липучке
На яблоках осталось много дыр
Принёс их Ёжик и сказал "Фыр-фыр!!"


Всегда найдётся длинный хобот серый
Принадлежащий существу больших размеров
Слон может точно воду им дозировать
Приветствовать вас и жестикулировать


Плотину прочную прям посреди реки
Построили две ловкие руки
Откуда столько веток он припёр?
Строитель плоскохвостый, пан Бобёр


А кто там на опушке роет норку?
Земли уже нарыл большую горку
Понятно всё по рыжему лицу
Мы видим чернолапую Лису


А ты не ешь, не спишь который день
Сидишь в окно глазеешь словно пень
Не лезет ни салат и ни десерт
Ты, может, меланхолик-интроверт?


Возьми рюкзак, усталый академик
Тепло оденься, сядь на старый велик
Протри от ржавчины железный двухподвес
И дуй на выходные прямо в лес
О, наш человек)))
источник

AP

Alexander Pihtelev in technicalwriters
Коллеги, добры день, нужна ваша помощь в понимании вопроса, бывает ли алгоритм программы отдельным документом и если бывает то чем он определен?
источник

VI

Vladimir Izmalkov in technicalwriters
По ГОСТу?
источник

AP

Alexander Pihtelev in technicalwriters
Да
источник

VI

Vladimir Izmalkov in technicalwriters
Гляньте пояснительную записку по ЕСПД
источник

AP

Alexander Pihtelev in technicalwriters
То что в пз есть раздел это да, подобный раздел и в других документах встречается. Имеется ввиду не встречался ли и не приходилось ли эту часть выносить отдельным документом? Или отдельным документом можно это выполнить только как схему (алгоритм)
источник

VI

Vladimir Izmalkov in technicalwriters
Ну, если заказчик чего-то очень хочет, то обычно это становится возможным (даже в нарушении стандартов и логики). Мне - пока не встречалось. Здравый смысл подсказывает, что схему легче всего вынести отдельным документом.
источник

L

Luiza in technicalwriters
Иногда алгоритм вносят в описание программы документ, правила все заданы в ГОСТ как алгоритмы описывать, ваше право куда вставлять
источник

Х

Хома in technicalwriters
На своей практике мы заводили отдельный документ со своим кодом и пихали в него все, что связанно с работой ПО: алгоритм, логика, описание принципов формирования команд/сигналов и т.д. Вообще это удобно было и для заказчика и для нас: все всё видели и понимали.
источник

AP

Alexander Pihtelev in technicalwriters
@BoBacTbli, @moonyalun, @Xoma_san - Спасибо!
источник

ДБ

Данил Боровков... in technicalwriters
Всем привет. Есть ли у bare metal русский аналог? помимо "голое железо". И используете ли вы абберивиатуру "bare metal" в документации?
источник

AS

Anna Sha in technicalwriters
Коллеги, поделитесь, пожалуйста, опытом. Есть готовое ТЗ на АИС, по ГОСТу. Нужно его разделить на два ТЗ, для двух исполнителей, каждому отдается разработка части функционала, но при этом разделенные блоки тесно переплетаются между собой. Если был такой опыт, как лучше сделать такое разделение, чтобы не потерять важную информацию о системе в целом, четко отделить часть, которую разрабатывает конкретный исполнитель и при этом не выходить за рамки ГОСТ по возможности?
источник

M

Maksim in technicalwriters
Я в таком случае (безотносительно ГОСТ) делал пометки по тексту - "данный пункт не относится к работам, которые необходимо выполнить в рамках настоящих Требований заказчика и приведён для описательной полноты настоящих требований заказчика"
Громоздко, но зато подрядчик знает точно что его что нет и не теряются существенные условия тз когда происходит его разделение и потом может и изменения
источник

AS

Anna Sha in technicalwriters
Была у меня и такая идея, спасибо!
источник

DM

Dina M. in technicalwriters
Данил Боровков
Всем привет. Есть ли у bare metal русский аналог? помимо "голое железо". И используете ли вы абберивиатуру "bare metal" в документации?
Пустое железо?
Но в моей практике про железо в официальной документации ни разу не писали, использовал описательные конструкции.
источник

ДБ

Данил Боровков... in technicalwriters
Dina M.
Пустое железо?
Но в моей практике про железо в официальной документации ни разу не писали, использовал описательные конструкции.
Это какие, например?
источник

VI

Vladimir Izmalkov in technicalwriters
Maksim
Я в таком случае (безотносительно ГОСТ) делал пометки по тексту - "данный пункт не относится к работам, которые необходимо выполнить в рамках настоящих Требований заказчика и приведён для описательной полноты настоящих требований заказчика"
Громоздко, но зато подрядчик знает точно что его что нет и не теряются существенные условия тз когда происходит его разделение и потом может и изменения
Не очень красивый подход. Но в целом одновременная разработка связанных компонент системы разными разработчиками по ТЗ - это как жонглирование гранатами без чеки имхо. Был опыт. Так себе удовольствие.
источник

VI

Vladimir Izmalkov in technicalwriters
Anna Sha
Коллеги, поделитесь, пожалуйста, опытом. Есть готовое ТЗ на АИС, по ГОСТу. Нужно его разделить на два ТЗ, для двух исполнителей, каждому отдается разработка части функционала, но при этом разделенные блоки тесно переплетаются между собой. Если был такой опыт, как лучше сделать такое разделение, чтобы не потерять важную информацию о системе в целом, четко отделить часть, которую разрабатывает конкретный исполнитель и при этом не выходить за рамки ГОСТ по возможности?
Может лучше разделить ТЗ, а потом к каждому в приложение общее ТЗ подложить. По тексту и объяснить зачем
источник

VI

Vladimir Izmalkov in technicalwriters
Dina M.
Пустое железо?
Но в моей практике про железо в официальной документации ни разу не писали, использовал описательные конструкции.
Если я правильно понимаю, это концепция, когда софт запускается сразу на железке (без операционной системы, по сути). Адекватных переводов на русский не встречал. Лучше привести оригинальный термин и его пояснения по-русски имхо
источник

AS

Anna Sha in technicalwriters
Vladimir Izmalkov
Не очень красивый подход. Но в целом одновременная разработка связанных компонент системы разными разработчиками по ТЗ - это как жонглирование гранатами без чеки имхо. Был опыт. Так себе удовольствие.
Полностью согласна) Но задача стоит именно так, там госзаказчик и все вытекающие из этого особенности, жонглирование гранатами в танце на минном поле:)
источник