воскресенье, 6 января 2013 г.

Обеспечение полного просмотра изменений в коде

Бывают ситуации, когда просмотр кода (code review - здесь и дальше буду использовать русский перевод, как бы непривычен он не был) становится обязательным  шагом процесса разработки. Например, в случаях работы с высоконадежной и/или чувствительной частью системы, когда уже недостаточно простого QA-процесса. Open-source проекты живут благодаря просмотру кода. Для них он позволяет масштабировать знания ключевых разработчиков на головы многих участников проекта.
Я бы не хотел затрагивать чувствительные и холиворные вопросы на тему "нужно / не нужно" и "какова цена приносимой пользы?". Поэтому просто расскажу как просмотр кода у нас заработал.

Дано:

  • продукт с достаточно коротким циклом выхода новой версии (от 1 недели до 3 месяцев);
  • устоявшийся процесс внесения изменений в продукт и выпуска новой версии;
  • пост-травматический синдром в половине команды после прошлой неудачной попытки внедрить просмотр кода.

Задача:

Обеспечить 100% (полный) просмотр кода  другими разработчиками (не-авторами) всех изменений перед их выпуском.

Решение (?):

Сразу выбросил топорную версию - поставить обязательный просмотр кода после кодирования и перед QA. Очень уж много недостатков:
  • более каскадная модель получается - еще одно звено в цепи скорость доставки не увеличит;
  • ответственность выбора того, кто будет просматривать код, лежит на авторе;
  • необходимость автором кода совершать действие, чтобы инициировать процесс просмотра кода (как  - уже другой вопрос. Важно то, что автор должен об этом не забыть).

Некоторое время назад пользовались средствами для просмотра кода - Code Collaborator и Cruicible. При всех удобствах, ими предоставляемых (комментарии, баги, подсветка синтаксиса, история изменений), все же к ним было необходимо было привыкнуть, что часть команды сделать так и не смогла. Кроме того, такие инструменты по факту создавали разработчикам еще один (параллельный) список задач, который был отдельным от системы отслеживания задач (а она очень широко используется), что не добавляло порядка. Иными словами, за задачами на проект и багами разработчик должен был смотреть в таск-трекер, а для просмотра кода - в Collaborator или Cruicible. Да, Cruicible тесно интегрирован с JIRA, но создать общий dashboard или Agile desk с задачами на просмотр кода нельзя.
Есть и еще один важный недостаток - разработчик-автор должен руками создавать задачу на просмотр кода (т.е. включать туда список изменений и назначать ревьювера) - что оставляет уйму возможностей для ошибок вида: забыл, сделал позже, не того ревьювера указал, не те изменения включил, последнее исправление забыл включить и т.п. Причем, чем меньше изменение, тем больше цена дополнительной работы связанной с поднятием задачи. Как следствие, чтобы поддерживать это в работоспособном состоянии требуется  административное давление.

Хотелось большей автоматизации и более быстрого отклика на код, который уходит в VCS. В идеале - чтобы автор вообще ничего дополнительного не делал для того чтобы его код был просмотрен. Выложил код в VCS - жди когда на плечо ляжет тяжелая рука ревьювера, который попросит объяснений и денег даст обратную связь.
Соответственно и ревьювер тоже должен только получать уведомление о том, что есть код, на который ему стоит взглянуть.

Для выполнения цели, нужно следить за количеством кода в версии, который еще не просмотрен и доводить это количество до нуля на предрелизной подготовке, не позже. Отслеживание такой тенденции - дело самой команды, хотя можно поручить это QA или руководителю проекта.

На этом этапе сформировалось понимание наших внутренних ограничений на решение задачи:
  1. Просмотр кода не должен тормозить цикл разработка -> QA -> разработка;
  2. Минимальное количество мануальных действий от автора и ревьювера, чтобы сделать просмотр кода;
  3. Метрика, способная в реальном времени показать количество непросмотренного кода;
  4. Задачи на просмотр кода должны быть интегрированы с таск-трекер и (в идеале) не должны отличатся от других задач - на них можно списывать время, заводить подзадачи, переназначать их на других исполнителей и т.п.;
  5. Ревьювер должен легко и просто видеть изменения с подсветкой синтаксиса и легко находить историю изменений.


Получилась следующая схема:
Здесь должна быть ваша реклама


  1. Разработчик автор пишет и отправляет код в VCS;
  2. Некий самописный инструмент (пока не знаем что это) собирает список всех изменений за определенный промежуток времени;
  3. Этот же инструмент создает задачи в таск-трекере на просмотр изменений, которые он собрал. Скорее всего, здесь нужна будет какая-то агрегация, потому что коммит = задача на просмотр может породить их слишком большое количество и будет сильно зависеть от стиля работы конкретного автора (кто-то любит частые коммиты, кто-то редкие);
  4. Ревьювер получает уведомление о новой задаче на просмотр от таск-трекера. Он также видит её в своем списке задач. Задача должна содержать в себе детали, достаточные для быстрого (в один клик) перехода к коду;
  5. Здесь случается уличная разработческая магия: автор и ревьювер обсуждают изменения. Если ревьювер находит ошибки - он заводит их в трекере. Или, что чаще, автор их тут же исправляет. Если выясняется более глобальная недоделка - поднимается дополнительная задача, которая даже может попасть в версию;
  6. Ревьювер закрывает задачу (один клик в таск-трекере);
  7. Руководитель проекта (Scrum master?) собирает количество открытых задач на просмотр и показывает его в виде графика команде - оно должно выходить в 0 в конце спринта и/или перед выпуском версии.

А где же здесь QA? А там же где и был - сразу (и в параллель) с разработкой. Да, есть риск что QA найдет ошибку которую должен был найти ревьювер - но это должно стимулировать ревьювера быстрее браться за задачи на просмотр.

Осталось прояснить несколько моментов работы "самописного агрегатора":
I. Как агрегировать изменения по времени? Договорились на одном дне (сутках). Так, чтобы утром каждый разработчик мог видеть задачи на ревью кода который вчера написал его коллега. На утреннем стенд-апе он получит устное описание изменений - в задаче увидит код. Удобно.
II. На кого назначать задачи на ревью? Каждый разработчик всегда знает какой-то кусок кода лучше, а какой-то хуже. Этим принципом и стоит руководствоваться при назначении ревью задачи. Каждому разработчику был дан инструмент, в котором он мог отметить в каком модуле системы он хотел бы следить за изменениями. Агрегатор агрегирует изменения по модулям. Если есть несколько ревьюверов в одном модуле - ревью будет назначаться на них поочередно.
III. Что должно быть в описании задачи для более простого ревью? В нашем случае было просто так как наша VCS позволяет создавать URL буквально на все - от коммита до сравнения ревизий файла (а-ля-diff). В описание задачи входит список измененных файлов. Ревьювер в один клик может посмотреть, что было изменено, как про каждый файл, так и про весь пакет. Там же есть ссылки на задачи, для которых эти изменения и вносились. Да, здесь могут попадаться незавершенные задачи, но это ведь не повод ломать сборку и функционал, верно?

Пример:

В системе 3 модуля: GUI, Server и Database.
Есть команда из 3 разработчиков (в скобках модули которые они просматривают): Ivan (GUI, Server), Petr (Database), Anna (Server, Database).
За один день они внесли следующие изменения:
Ivan: Server change 1, Database change 11
Petr: GUI change 2, Server change 2
Anna: GUI change 3

На следующий день они получат следующие задачи на просмотр:
Ivan = GUI change 2, GUI change 3
Petr = Database change 11
Anna = Server change 1, Server change 2
Как видно, по одной задаче на разработчика. Ведь это всего лишь за один день :)



Вот наверное и все, немного цифр в конце. За 2 месяца работы команда из ~15 разработчиков создала ~300 задач на просмотр кода. Распределение было неравномерным - около четырех ревью-чемпионов просмотрело более 30 задач. Что было ожидаемо. Среднее время закрытия задачи - неделя, что наверно много и должно быть уменьшено.

Получилось достаточно объемно, где-то мог быть непонятным.
P.S.
Спасибо Мишегу за реализацию "самописного инструмента".

понедельник, 9 января 2012 г.

Избавляемcя от тормозов iPhone 3G

Не секрет что выход iOS 4.0 был прохладно встречен со стороны владельцев не очень новых iPhone. Новый функционал нравился всем, но вот отчеты о заметном снижении производительности постепенно перестали нуждаться в доказательствах, так как проявлялись практически у всех владельцев версии 3G. Я думал, что причина кроется исключительно в новых программах – так как их пишут уже с расчетом на новое мощное железо последних моделей и старые модели просто перестают тянуть. Однако вскоре и старые-добрые проверенные софтины начали тормозить.

Одной из причин таких тормозов оказался файл consolidated.db - в который iPhone педантично складывает географические координаты перемещений своего хозяина. Когда его размер становится внушительным – всякое обращение к нему (а значит и к службе геолокации) становится долгим и ресурсоемким. Тормоза с геолокацией я заметил, но связать их с этим файлом мне помогла статья на Хабре. В ее заключении автор находит противоядие – злобный файл должен быть потерт (в разных смыслах) – это совершенно безопасно для стабильности iPhone. И это совсем не проблема, если ваш iPhone взломан. Мой случай был иным.
Итак, нужно было всего-навсего стереть/изменить некоторое содержимое (или сам файл) на iPhone.

Попытка номер раз

Создаем бекап iPhone. Находим его на диске. (C:\Users\YOUR_USERNAME\AppData\Roaming\Apple Computer\MobileSync\Backup\). Скачиваем iPhone Backup Browser. Находим файл (ого, 26 Мб!)


В столбце с именем “Key” находится название этого файла в директории с бекапом. Удаляем файл “4096c9ec676f2847dc283405900e284a7c815836” (есть подозрение, что это имя для версии операционки 4.2.1 будет таким же на всех iPhone). Командуем iTunes восстановить iPhone из бекапа. iTunes пытается, но сообщает об ошибке. Что ж, видимо он проверяет наличие файла.

Попытка номер два

Создаем пустой файл с именем “4096c9ec676f2847dc283405900e284a7c815836”. Та же проблема. Видимо iTunes проверяет содержимое/размер файла.

Попытка номер три

Через SQLite Manager открываем базу данных файла и грохаем все содержимое (как в статье на Хабре). Базу сжимаем (VACUUM). Теперь это 9Мб вместо 0 и 26Мб. Заливаем на iPhone. iTunes ругается. Видимо, размер файла должен быть тот же.

Попытка номер четыре

Чистим базу, но VACUUM не вызываем – размер тот же (26 Мб). Надежда на, то что в пустых данных iPhone искать будет быстрее. Заливаем на iPhone. Та же проблема. То, чего я и боялся – iTunes сверяет хэш-сумму. Придется найти ее.

Попытка номер пять

Легенда гласит, что все хэши хранятся здесь (Manifest.mbdb, Manifest.plist). Но до расшифровки HEX значений я так и не добрался, поскольку вышел на iBackupBot. Программа позволяет экспортировать/импортировать файлы из iPhone/iPad бэкапов.


Осталось только достать новенький незамыленный consolidated.db с его хэш-суммой чтобы подменить им мой оригинальный. Такой файлик я взял с нового iPad, который недавно поселился у меня дома. С iPad-ного бекапа экспорт – в iPhone-ный бекап импорт. iTunes съел, iPhone снова летает.

Если у вас проблемы в производительностью iPhone 3G, особенно при доступе к геолокационной службе, план действий следующий. Скачиваете iBackupBot, находите новый consolidated.db и импортируете его в ваш бекап. После чего восстанавливаете iPhone из этого бекапа и еще 6-12 месяцев стабильной работы вам обеспечено. Потом процедуру придется повторить (мне так кажется).

Большое спасибо ребятам из www.icopybot.com – их триальная версия ничем не уступает платной и в ближайший год мне не понадобится.

PS

Мои перемещения по Москве за последние полтора года, внимательный зритель найдет район, где я живу (любой ай-девайсовод такую карту может составить – вот так или вот так):


понедельник, 24 октября 2011 г.

Как эффективно читать корпоративную почту

Как ужиться программисту с потоком электронных писем которые приходят к нему в течении рабочего дня? Особенно это актуально в больших компаниях где существуют много рассылок, оповещений и просто спама от сотрудников :)

Дано: программист - т.е. ИТ-инженер основная обязанность которого - писать код. У программиста есть почтовый клиент в который время от времени падает почта.

Цель: Программист должен писать хороший код и при этом отвечать на письма с задержкой не более чем в день (большие ответы) или 3-4 часа (для маленьких ответов). В идеале второе должно не ухудшать эмоционального состояния программиста.

Решение (абсолютно субъективное):

1) Оповещение
Отключаем визуальное оповещение в почтовом клиенте о новых письмах. Никаких всплывающих окон, никакого мигания в системном трее (или упаси Боже в панели задач), ни-че-го. При этом выставляем интервал проверки почты в минимум (1 мин как правило). Читаем почту только тогда, когда сами этого хотим - а не по воле нотификатора :). Для этого и нужно всего-то запустить / открыть почтовый клиент. Малый интервал проверки необходим для актуального отображения состояние почты - чтобы не нужно было совершать мануальных действий для проверки. Такая модель позволяет не прерываться во время работы в потоке.

2) Сортировка
Как за один взгляд на почтовый ящик понять - есть в нем важное / критичное письмо или нет? Есть способ который приблизит нас к идеалу. Вероятность того, что письмо требует ответного действия повышается по степени адресованности письма. То есть, если письмо только вам и никому больше (вы в To:) - очевидно от вас ждут ответ. Ситуация обостряется если в копии стоит начальник (т.е. он теперь тоже знает что от вас ждут ответ). Ну и совсем критично если в копии стоит взвод начальств разного ранга и ответственности. Поэтому можно задать просто правило - высший приоритет - в адресате только вы, отправитель начальник. Далее в адресате вы, в копии начальник. Далее в адресате вы в копии много разных людей. И наконец в адресате только вы (письмо один на один).
Степень критичности резко понижается если вы стоите в копии (CC:)/ Как правила это письма "for your information" и действий не требуют. Однако, имеет смысл в них все равно вникать - вас же туда не зря поставили :)
Письма, на которые вообще редко приходится реагировать - это всевозможные рассылки. Определить их достаточно просто - они высылаются на групповой адрес в который вас внесли. Самый низкий приоритет (я их могу не читать по 1-2 недели).
Стоит отметить отдельностоящие письма от роботов - вроде баг-трекера или билд-агента. Здесь сложно сказать что-то про приоритет - зависит от ситуации и состояния проекта в который вы вовлечены. Отдали фичу на тестирование - нотификация от багтрекера должна иметь наивысший приоритет. Начальник повесил таску которую нужно начать делать через месяц - ответ очевиден.

3) Написание ответа
Читаем новое письмо. Требуется ли от нас какие-то ответные действия? Если нет - отмечаем письмо как прочитанное. Если да - оцениваем время которое требуется на написание ответа. Если оно меньше, чем время которое мы уже потратили на чтение этого письма, то пишем и отправляем ответ прямо сейчас. Если больше, оставляем непрочитанным (как бы кладем его в список todo). В определенное время (отведенное у вас на почту - например после обеда или сразу после прихода на работу утром) идем от самых старых писем к новым. Учитывая приоритет конечно.

Примерно так. Хочу заметить что это исключительно мой опыт, поэтому если я где-то повторился с какой-нибудь общеизвестной практикой, то это случайное совпадение :)

воскресенье, 23 октября 2011 г.

Зачем нужен iPhone?

Исключительно из исторических побуждений хочется зафиксировать историю использования iPhone. Потому что я вижу, что девайс остается тем же, а использовать я его начинаю по-другому. На данный момент я им пользуюсь уже 2,5 года (да, это iPhone 3G).


1) Книжка
Первая и самая используемая программа. ShortBook. Читает книжки в формате fb2 (а другой и не нужен на самом деле). Сам умеет ходить в интернет и книжки скачивать. Цитаты, закладки, все дела. Мое первое платное приложение. Ни разу не жалко.

2) Газета
Да-да, именно газета. Причем составленная из колонок по моему вкусу. Утром за чашечкой чая перед рабочим днем очень занимательно почитывать колкие статьи Колесникова о Путине, рассматривать фотографии медведей с Камчатки, следить за анонсами концертов любимых групп, читать литературную юмористику. Да, как вы уже догадались, речь идет о RSS-рассылках и iPhone нужен исключительно как агрегатор всех подписок. Причем желательно с "лайками" и "прочту потом". С эти успешно справляется Google Reader и MobileRSS. Google Reader агрегирует, задержек не замечено. MobileRSS синхронизирует, быстро скачивает новые посты, кэширует картинки и способен работать в оффлайне. При этом стабилен и не тормозит.
Второе платное приложение. Год пользовался халявной версией (немного рекламы вверху), потом понял что пора отдать долг разработчикам.
Особняком стоит Коммерсантъ. Бесплатно имеешь последнюю версию газеты в телефоне. Удобно, но реализация программы на 2ку. После 1-2 мес использования нужно переустанавливать - перестает запускаться. А так, коммерсант как коммерсант. К слову, Ведомости, АиФ и Комсомолка унылы чуть менее чем полностью.


3) Навигация
Сначала это была стандартная Google Maps. Более чем достаточно чтобы бродить по мегаполисам (опробованы лично: Москва, Петербург, Лондон, Берлин). К сожалению в мобильной версии не показывает маршруты общественного транспорта, хотя значки остановок стоят. Должны исправить, функционал очевиден.
Metropolitan. Использовал для Москвы - сам находит ближайшую станцию. Платная версия показывает на карте входы в метро, но сам не пользовался - научился их и так находить. Прога оказалась настолько крутой, что разработчика взяли в Яндекс где он ее скопипастил под новым именем. Яйца те же.
Яндекс.Карты. Должна быть у каждого автомобилиста со смартфоном (да, Android версия тоже есть). Прокладывает маршрут с учетом пробок, знает переулки / проезды по дворам, имеет бесплатный трафик у Мегафона и Билайна. Пока от навигатора отличается только отсутствием голосовой поддержки и менее информативном (из-за размера) экраном. На 3G наблюдаются периодические тормоза из-за объема файла базы данных с локациями владельца iPhone. Лечится исключительно iPhone-нными плясками с бубном (напишу об этом отдельно).
MyBank. Показывает на карте банкоматы и отделения практически всех крупных российских банков. Полезность средняя, так как много банкоматов в офисах к которым без пропуска не подойти.

4) Прочее
GymGoal. Для занятия фитнесом - журнал тренировок, подбор программы. Наверное, лучшая в своем классе.
SafeWallet. Просто чтобы хранить секретную информацию (паспорта, банковские карты, и т.п.) не в заметках.
AccuWeather. Бесплатно но подробно о погоде. Вроде угадывает :)
Skype + домашний Wifi превращает iPhone в междупланетный телефон.

Чего я не делаю на своем iPhone так это не смотрю видео. Время дает о себе знать, иногда и youtube тормозит. А видео через iTunes загруженное, iPhone вообще не видит. Особо не копал, но вообще это странно.

Вот интересно что может дать из всего вышеперечисленного iPad. И насколько лучше/хуже?

четверг, 21 июля 2011 г.

Неодушевленные люди

То, чем я сейчас занимаюсь на работе называет "resource manager". Казалось бы, это про ресурсы. А про какие ресурсы? Какие вообще могут быть ресурсы в ИТ компании? Рабочие компы, сервера? Конечно нет. Их три. Деньги, время и люди. Дык вот я занимаюсь последними двумя.

Особенно конечно - людьми. Есть пул задач, к ним есть пул заинтересованных лиц (которые хотят эти задачи сделать как можно быстрее). Есть пул разработчиков с разными скилами, которые эти задачи могут выполнять. Еще есть график отпусков, зависимости от соседних команд и индивидуальных особенности всех участников процесса. Собственно моя роль - соотнести один пул на другой, причем так, чтобы это всех устроило.

На чем тут стоит акцентировать внимание? Можно на разном. Чтобы заказчики были в восхищении. Чтобы разработчики делали только интересные задачи. Чтобы критичные задачи делались с хорошим качеством, а неважные - с неважным :). Стратегий поведения много - обидно то, что всем гарантированно не угодишь. Также обидно что люди быстро к хорошему привыкают и когда качество вдруг падает - начинают сильно жаловаться. Причем это относится как к заказчикам, так и к разработчикам.



И все-таки чем больше организация людей становится - тем дальше она от этих людей отдаляется. Вот, роль по назначению задач называется управляющий по ресурсам. Люди это все-таки не просто ресурс - про который можно четко сказать, много его или мало (как деньги или время). Человек в один день - это много (программизмы поперли), в другой - мало (жена ушла - все мысли об этом и работать некогда).

Я свою стратегию выбрал. Назовем её так "счастливый малыш - счастливая мама".
Думаю что всегда стоит добавить в копоративный двигатель масла человеческого отношения к людям. Тогда - может и мощность увеличится...