Кто и как объясняет пользователю как работает программный код на естественном языке?

1. Олег (olbu) 19.10.16 14:48 Сейчас в теме
Здравствуйте!
Может уже обсуждалось, но я не нашел...
Как вы объясняете пользователю/заказчику/аналитику/руководителю, как работает, ну например обработка по расчеты цены услуги на доставку? Эту обработку делали до меня, ее смысла я не знаю, но нужно ее "декодировать" для фин директора... По программному коду для меня все понятно, но как начинаю объяснять - все равно получается упрощенный программный код... Заказчик начинает возмущаться, ему тяжело меня понять.
Нужно объяснить так, что бы не затрагивать терминов программирования - на "человеческом языке"...
Как оказалась, это для меня трудно... постоянно всплывают программные термины, которые "бесят" фин директора :)...
Хотел попросить Вас поделиться своим опытом...
Ответы
2. Алекс Кон (alex-l19041) 9 19.10.16 14:55 Сейчас в теме
(1) olbu,
термины
надо заменить аналогами или синонимами.
3. Иван Сусанин (IvanSusanin) 19.10.16 14:58 Сейчас в теме
Напишите текст описания на бумаге или в текстовом файле.
потом замените "не кошерное" синонимами.
4. Олег (olbu) 19.10.16 15:02 Сейчас в теме
(3) IvanSusanin, ну сейчас так и делаю, смотрю код, выписываю в тетрадь алгоритм и потом пытаюсь переписать алгоритм в понятный текст...
5. Олег (olbu) 19.10.16 15:03 Сейчас в теме
(2) alex-l19041, не всегда получается, например условие - как не пытаюсь, так и выходит "если" :)
6. Иван Сусанин (IvanSusanin) 19.10.16 15:14 Сейчас в теме
если - синонимы

ежели, буде, когда, коли, коль (скоро); разве, если бы, кабы, неравно, разве, даже если; делать что, (не то, если нет, в противном случае, иначе) будет то; коль скоро, разве что, в случае если, если только, благо, на случай если


тяжело рисовать маленького котенка из седьмой красной перпендикулярной линии, нарисованной прозрачным цветом.
но Вы же профессионал.)))


если серьезно, попробуйте писать не как работает обработка, а зачем она нужна.
это слегка не одно и тоже.
7. Олег (olbu) 19.10.16 15:26 Сейчас в теме
(6) IvanSusanin, Спасибо. Попробую.
8. Nikolay D (nikolayD) 7 19.10.16 17:02 Сейчас в теме
(5) olbu,
так и выходит "если" :)
"вопрос?" -> "Да"или"Нет" -> действие.
Вообще вопрос в визуализации... Давно меня попросил директор (в очень прошлом программист) схему нарисовать по всем правилам логики... Я спросил, может не стоит по логике, а попроще нарисовать? Услышал категоричное - Нет! Нарисовал по логике, директор не оценил и попросил попроще, пришлось попроще рисовать.... В принципе, устроило вертикальная- линейная структура из прямоугольничков в экселе с небольшими ответвлениями.
Но тут как бы не совсем в тему, не совсем понятно, что в обработке делается... Может достаточно сместить приоритет на результат и как бы объяснять его так сказать с конца, не вдаваясь в массивы данных и т.п.?
Вообще, вопрос у заказчика "как работает" может возникнуть только в одном случае - если не работает... если результат рабочий - то такого вопроса практически не должно быть.
Если работает, но возник вопрос, значит спрашивающий человек разбирается в вопросе программирования и считает, что там возможно выбран заведомо неверный метод, который потом может выдать ошибку. Либо просто проверяет понимание кода.......
9. Сан Саныч (herfis) 111 19.10.16 17:19 Сейчас в теме
(1) olbu, Ключевая фраза - "ее смысла я не знаю". А руководителю нужно именно это. Попытайся смысл все-таки понять.
Код можно читать и пересказывать и не понимая его смысла. Соответственно, смысла не будет и в его пересказе.
Это как вместо фразы "сортирует по порядку" пытаться рассказывать какие перестановки и в какой очередности делаются.
10. Олег (olbu) 20.10.16 09:29 Сейчас в теме
Вот в смысле - то и дело... Сложно понять, какой смысл был при постановке задачи другому программеру, если конечно, нет в коде комментариев с подсказками. А это часто бывает так...
11. Денис Ан (Denis_CFO) 4 20.10.16 10:26 Сейчас в теме
(10) olbu, а проанализировать значения "на входе" и "на выходе", а в совсем в непонятных местах посмотреть листинг и результаты написать на красивой бумажке не получится?
12. Сан Саныч (herfis) 111 20.10.16 11:00 Сейчас в теме
(10) olbu, А кому сейчас легко? :)
Слава богу, в 1С редко встречаются алгоритмы высокой сложности и совсем уж неочевидных концепций. 1С большей частью скриптописалка.
Но если реализуется какая-то математическая модель или концепция, с который ты незнаком даже в теории - то восстановить концепцию по реализации в самом деле может быть практически нереально.
13. Игорь Полосков (ipoloskov) 20.10.16 11:10 Сейчас в теме
Попросить в помощь бухгалтера-пользователя данной обработки. Вместе с ним выяснить смысл неясных для вас моментов, восстановить модель и описать ее.
14. spartak_ss_88@mail.ru (spartak_ss_88) 6 20.10.16 11:27 Сейчас в теме
Жестикулировать побольше предлагаю, ловкость пальцев применить.
15. Олег (olbu) 20.10.16 13:07 Сейчас в теме
(11) Denis_CFO, Приму к сведению.
16. Олег (olbu) 20.10.16 13:08 Сейчас в теме
(13) ipoloskov, В настоящий момент, запрещено задавать вопросы пользователям... :) Как понимаете, свои заморочки у руководителя...
Оставьте свое сообщение