Пам’ятка про коментування в Bitrix

Є два різні типи коментарів:

1. Загальний коментар у задачі — для статусу та історії.

2. Коментар до залогованого часу — текст на вкладці “Час” в задачі.

1) Загальний коментар у задачі

Коли писати

• В оперативному режимі — відразу після змін у задачі,

• або щодня до 10:00, якщо зміни були напередодні/зранку.

Навіщо

• Для збереження історії - часто, коли виникають питання по задачі в клієнта, можна оперативно ознайомитись із ходом роботи, не відволікаючи аналітика/програміста).

• Фіксація змін - щоб у будь-який момент можна було відстежити, що саме було зроблено в задачі й коли.

• Синхронізація команди - усі учасники бачать останні оновлення без потреби ставити уточнювальні питання.

• Зменшення ризику непорозумінь - чіткий письмовий слід допомагає уникати помилок через усні домовленості чи забуті деталі.

• Оперативність рішень - менеджер або колега може одразу підхопити задачу або внести корективи, не витрачаючи час на з’ясування контексту. 

Коли не потрібен

• Якщо по задачі реально не було руху.

Що писати (лише, якщо відбулись зміни в задачі)

• Коротко й по суті: статус, що змінилося, наступні кроки/дедлайни, що заважає/проблеми.

Приклади:

• ТЗ погоджено, даю посилання на ТЗ, задача передана в розробку програмісту, очікую на тестування 

• В ТЗ внесені зміни після зустрічі із Замовником, віддам на узгодження Замовнику 14.07

• Провели чергову зустріч по прийманню вимог по задачі. Багато нових вимог від Замовника. Потрібно втрутитись менеджеру бо іде перевитрата часу (відмічаємо менеджера в коментарі).

• Під час здачі роботи Замовник висуває нові вимоги, які не передбачені в ТЗ, потрібно втрутитись менеджеру (відмічаємо менеджера в коментарі)

• Розробка по ТЗ завершена (відмічаємо аналітика/консультанта)

• Робота із задачею на паузі через форс мажор (вказуємо причину), планую відновити роботу з <дата>

2) Коментар до залогованого часу (обовʼязкова вимога для задач на поточне консультування) - 

Коли писати

• Кожного разу, коли логуєте час в задачі на консультації

Навіщо

• Цей текст часто бере бухгалтер для рахунку і надсилає клієнту, якщо той просить надати розшифровку виконаної роботи.

Що писати

• Конкретно що робили, який був запит, на якому обʼєкті системи, з ким контактували, який результат (якщо можна описати)

Шаблон (орієнтовний)

• [Дія] + [що саме робилося/назва документа] + (Опційно Назва компанії / бази / кого консультували - якщо декілька баз та Юр. осіб)

Приклад

• Питання по відображенню витрат на транспорт (Зерне)

• Консультація з проведення документу “Списання запасів” (Білінське)

• Вивантажено бекап, оновлення конфігурації та оновлення медової стиковки

• Оксана Тищенко. Опрацювання питання по обліку заборгованості по клієнтах

Важливо - Інформація має бути детальною, якщо це стосується розробки без узгодженого ТЗ та тестування!

А для задач на розробку згідно ТЗ, правило коментування часу не розповсюджується. 

Головна вимога фіксувати реальний час.