Эссе о разработке игр, мышлении и книгах

Уникальные идентификаторы для связи исходников. Как?

Хочу странного, может подскажете способ сделать.

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

Фичей не в смысле больших user-story, а в смысле конкретных пунктов, реализацию которых надо контролировать. Например «имя гильдии должно быть уникально», «Это поле должно отображаться только залогиненому пользователю».

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

Вопрос вот в чём: как делать идентификаторы, которые будут связывать фичи с кодом?

Варианты, которые вижу:

  1. Писать руками. Проблемы: геморрой и простор для ошибок/опечаток.
  2. Плагин для emacs (любого другого редактора), который в файле с фичами генерирует уникальные идентификаторы, после чего копировать их куда надо. Проблемы: его надо сделать, нужно поддерживать уникальность между файлами, хочу фичи не только в отдельном файле, но и в коде, если это будет удобно.
  3. Литературное программирование: писать фичу сразу там, где реализуется. Проблемы: фича реализуется в нескольких местах (код, тесты, вёрстка, документация), поэтому идентификаторы всё равно нужны.
  4. Идентификатором делать сам текст фичи. Проблемы: занимает много места, текст может меняться и будет геморойно менять его везде.

Сделал email рассылку о новых статьях

Подписаться можно справа от поста ⟶

Или под постом, если вы смотрите мобильную версию.

Это на случай, если вы не пользуетесь RSS, но хотите следить за блогом.

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

О книге «Нейрокопирайтинг»

Обложка книги «Нейрокопирайтинг» Дениса Каплунова

Или 100 способов впарить не краснея. Книга писана копирайтером для копирайтеров и тем прекрасна. Состоит из 110 советов по оформлению текста для впаривания. Было интересно посмотреть на незамутнённые «продающие» тексты и потренироваться определять манипуляции через них. Однако книгу читать не всегда приятно. По нескольким причинам.

Любопытнее всего сравнить её с «Евангелистом бизнеса» о которой я уже писал. Книги частично про одно и то же, но авторы стоят на противоположных концах этического спектра. Если в «Евангелисте» ключевым мотивом создателя текста считается донесение полезной информации до читателя, то в «Нейромаркетинге» — принуждение читателя сделать действие, независимо от его полезности. И хотя автор «Нейромаркетинга» — Денис Каплунов — часто повторяет в книге, что за этикой надо следить (и всё такое прочее), по текстам и рассуждениям видно, что следить можно и сквозь пальцы.

Далее

О книге «Алмазный век»

Обложка книги «Алмазный век или букварь для благородных девиц»

Алмазный век или букварь для благородных девиц Нила Стивенсона я взялся читать из-за второй части названия. В статье про электронную книгу для детей на dev.by кто-то упомянул букварь как пример крутой технологии, меняющей общество. А я уж очень соскучился по хорошей «Лемовской» футурологии. Лем-то уже не пишет, по объективным причинам… Ну, думаю, вот оно! Лауреат премии Хьюго ерунду не напишет! Ерунду, конечно, не напишет, но и правдоподобно описывать будущее тоже не обязан :-D

Получилась у Стивенсона добротная сказка для взрослых, с парой оргий, чернухой, мутной логикой и множеством искусственных неологизмов. Как-будто достоверность описания будущего зависит от количества новых терминов и неожиданных применений технологий.

Далее

О книге «Поток»

Обложка книги «Поток»

«Поток — психология оптимального переживания» Михая Чиксентмихайи — медленное разочарование. Ощущение, как-будто начал читать хорошую техническую литературу, а закончил сочинениями Пауло Коэльо.

Покупал книгу для того, чтобы разобраться с «технической» составляющей состояния потока (концепцию которого и предложил автор книги), понять как им управлять. Оказалось, что интересующим меня темам посвящено всего две первых (вводных) главы, а дальше Чиксентмихайи начинает продвигать свой (на мой взгляд стрёмный) взгляд на счастье и его достижение. Само собой, высшее счастье у автора — это находиться в состоянии потока.

Как я понял, этой книгой исследователь подводит итоги своей работы и философских поисков и пытается поделиться мудростью с миром. Я с этой мудростью не согласен, но некоторым она может быть полезна.

Поэтому разобью отзыв на несколько частей:

  1. Почему книга стрёмная.
  2. Почему книга может быть полезна.
  3. Что такое сознание (в представлении автора).
  4. Что такое поток (в представлении автора).
  5. Взгляды автора на счастье и почему я их не разделяю.

Далее