Делаем документацию здорового человека в Git на примере Docs Ozon / Хабр
https://habr.com/ru/company/ozontech/blog/695868/

Как мы ведём требования к ПО: формализация / Хабр
https://habr.com/ru/company/alfa/blog/694864/

Критично: срочно, сегодня обновите платформу "1С:Предприятие 8"!

Подробно в инфописьме 29958

Фирма "1С" доводит до сведения пользователей и партнеров, что в версиях платформы "1С:Предприятие" 8.3.22.1672, 8.3.22.1603, 8.3.21.1607, 8.3.21.1508, 8.3.21.1484, 8.3.20.2076, 8.3.20.2039, 8.3.19.1665, 8.3.19.1659, 8.3.18.1902, 8.3.18.1894, 8.3.17.2733, 8.3.17.2665 обнаружена критическая проблема, которая может привести к закрытию приложения в начале работы с программой.

Данная проблема НЕ проявляется:

- в других версиях платформы;
- в защищенных программных комплексах 8s, 8.3z;
- при работе в веб-клиентах, клиентах Linux, MacOS;
- в сервисе 1CFresh.com (1С:Предприятие через Интернет).

Изменение внешних условий 15.11.2022 может существенно повысить вероятность проявления данной проблемы – предполагается, что многие пользователи перечисленных версий завтра не смогут работать.

Проблема не приводит к потере данных пользователей.

В связи с этим пользователям перечисленных выше версий рекомендуется до начала рабочего дня 15.11.2022 обновить платформу "1С:Предприятие".

Версии с исправлениями станут доступны в течение 14.11.2022 в сервисе "1С:Обновление программ" на портале информационно-технологического сопровождения 1С:ИТС portal.1c.ru. Проблемные версии в ближайшее время перестанут быть доступными для скачивания.

Прямые ссылки для скачивания версий платформы для замены, дополнительная и актуальная информация будут публиковаться по мере готовности на странице https://info83.1c.ru.

Фирма "1С" просит партнеров оперативно довести информацию до пользователей, у которых эта проблема может проявиться, а также помочь им обновить версию платформы.

Мы приносим извинения всем, кого затронула данная проблема.

Краткий обзор (со ссылками) расширений VS Code для работы с документацией.

Интересный мультик о технологии 🏉SCRUM.
Коротко и по делу.

📌 Хорошая статья о том, что поменялось в новом стандарте ГОСТ 34.602-2020 «Информационные технологии. Комплекс стандартов на автоматизированные системы. Техническое задание на создание автоматизированной системы».
☝️Кто проходил "Школу аналитика", может найти в этой статье нарушение одного из четырех законов логики. Какое это нарушение?

Обратите внимание на сервис по проверке грамматики русского языка. Такой инструмент станет незаменимым помощником для составления писем, докладов и технической документации. Прилагаю пример проверки этой заметки:

📚 Пользовательские истории. 
Гибкая разработка программного обеспечения.

Автор: Майк Кон
Предисловие: Кент Бек

Как принять решение о том, что собой должна представлять программная система? А как добиться того, чтобы принятое решение отражало интересы самых разных людей, непосредственно или косвенно связанных с проектом? Рассмотрению этой проблемы и посвящена данная книга.

Скачать 📔

#литература | @notes_analyst

Несколько дней назад начали обследование на одном из предприятий. Хочу поделиться тем, что является важным в этой работе. Конечно - это подготовка к обследованию. Работа эта, как правило, не оплачивается, но от ее выполнения зависит успешное выполнение поставленных задач.
Что же необходимо обязательно сделать для перед началом обследования? Вот краткий перечень мероприятий:
✔️Составить организационную структуру проекта, желательно с матрицей ответственности;
✔️Провести мобилизацию проектной команды;
✔️Составить оперативный план проведения работ;
✔️Рассчитать финансовые показатели этапа работ и заложить временной и финансовый резерв;
✔️ Согласовать с заказчиком ключевых лиц и план проведения интервью;
✔️Подготовить и направить клиенту анкеты (опросники) для заполнения (это хорошее подспорье на интервью);
✔️Провести инструктаж проектной команды, чтобы добиться понимания каждым сотрудником цели работ, результатов и способов их достижения;
✔️Провести анализ заполненных анкет и подготовиться к интервью (каждому аналитику).
В этот список желательно еще добавить проведение ознакомительных мероприятий с командой заказчика. Это только поможет налаживанию взаимодействия.

Очень хорошая статья по работе с PlantUML
https://habr.com/ru/company/qiwi/blog/577606/

Примеры готовых скриптов
https://real-world-plantuml.com/

Ревью требований аналитиков: что, как, зачем. Качественные требования — Ксения Дмитриева на vc.ru
https://vc.ru/u/1271058-kseniya-dmitrieva/483893-revyu-trebovaniy-analitikov-chto-kak-zachem-kachestvennye-trebovaniya

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

​​📑 Как использовать макросы в Confluence, чтобы систематизировать и оформить документацию по продукту и процессам?

"Макросы - это программные алгоритмы действий, «упакованные»‎ в понятный графический интерфейс. Если проще, это внутренние инструменты Confluence, которые помогают делать документацию понятнее и удобнее."

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

#документация | @notes_analyst

Рекомендую к изучению данное решение
https://www.youtube.com/watch?v=psK2fZUtbf4&ab_channel=%D0%9A%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D0%B0%D0%98%D0%A2%D0%9A

Защиту от дурака надо всегда продумывать при проектировании.

Интересная мысль, пригодится при проектировании:

https://youtu.be/mhEXOUtOy2A

6 неправильных способов использовать BPMN, альтернативы BPMN
https://bpmn2.ru/blog/5-nepravilnix-sposobov-ispolzovat-bpmn

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

✔️ Что такое механизм интеграции, никто не понимает. Поэтому мы и затормозили оплату данного документа, в нем еще и цена была перепутана.
✔️ Дополнительные работы по разработке механизма интеграции на сумму ХХХХ руб. Просьба пояснить, что это такое. Никто у нас не понимает, в чем заключались данные дополнительные работы. Если мы принимаем документы на оплату, мы должны понимать, за что именно мы платим.Что касается закрытия 2 и 3 этапов работ, то напишем после обсуждения с руководством.
Интеграция всех файлов отсутствует.
✔️ Наверное, нам нужно организовать общую встречу: с нашей стороны пригласить всех участников проекта ... Вся наша команда хорошо помнит, что мы говорили об этих файлах, и что стоимость их входит в основные работы. И нужно совместно разбираться, что у нас относится к основным работам, что к дополнительным, а что к консультационным услугам. В настоящее время с квалификацией тех или иных работ полная путаница.

Такая ситуация возникает почти на каждом проекте, где документирование договоренностей с заказчиком, либо не ведется, либо ведется неудовлетворительно. С одной стороны, возникает иллюзия, что мы экономим время на составление и согласование "бумажек". С другой стороны, задумайтесь, сколько времени мы тратим на урегулирование споров, возникающих в последующем. Стоит ли оно того?