Существуют библиотеки на различных языках, имеющие общие черты. Это compojure, sinatra, grape, express, koa и подобные.

У них схожий подход к роутингу. Они не накладывают никаких ограничений и не предлагают структуру для организации url. Разработчики в таких условиях склонны не заботиться о структуре и впоследствии получают плохо поддерживаемый код.

Другая общая черта — это однонаправленность. Т.е. определенному запросу соответствует определенный обработчик. Разработчики вынуждены прописывать url строками в шаблонах. Нет возможности указать в виде конструкции языка, какой url сгенерировать. Это приводит к тому, что в представлениях остаются мертвые ссылки, и нет способа найти их, кроме как протыкать все страницы.

Я расскажу, как улучшить поддерживаемость кода в экосистеме Clojure, и покажу, как:

1. организовать url'ы
2. структурировать код обработчиков
3. использовать языковые конструкции для генерации url

Английское слово checklist переводится как контрольный список. По-русски звучит: чек-лист. При этом представляется длинный узкий лист бумаги, полученный в магазине после оплаты покупок. Возможно, из-за этой ассоциации с торговлей мне это слово не нравится. Но нравится или нет, а оно вошло в обиход, потому приходится использовать. На самом деле чек-лист — это список необходимых дел (процедур, операций). Это очень удобная памятка, по которой можно выполнять, как по цепочке, дело за делом, не опасаясь, что какое-либо пропустишь. Также по этому списку можно проверять, всё ли запланированное сделано.

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