Публичные контракты, как обеспечить их согласованность

21 мая в 09:49

Примечание: Антон из центра разработки Directum в Уфе рассказал на Хабр, как сократить время на разработку веб-сервисов, используя инструменты унифицированного описания контрактов и автоматической генерации кода.

  • ваша система состоит из множества взаимосвязанных сервисов?
  • всё ещё вручную актуализируете код сервисов при изменении публичного API?
  • изменения в ваших сервисах часто подрывают работу других, а другие разработчики вас за это ненавидят?

Если ответили да хотя бы один раз, то добро пожаловать!

Термины

Публичные контракты, спецификации – публичные интерфейсы, через которые можно взаимодействовать с сервисом. В тексте означают одно и то же.

О чем статья

Узнаете, как сократить время на разработку веб-сервисов, используя инструменты унифицированного описания контрактов и автоматической генерации кода.
Грамотное использование описанных ниже техник и инструментов позволит быстрее выкатывать новые фичи и не ломать старые.

Как выглядит проблема

Есть система, которая состоит из нескольких сервисов. Эти сервисы закреплены за разными командами.



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



Если сервисы-потребители не готовы к изменениям, то система перестает полноценно работать.



Как решить эту проблему, читай в нашем блоге на Хабр.

Directum | Как снять обучающий видеоролик: 10 секретов технического писателя

Как снять обучающий видеоролик: 10 секретов технического писателя

29 мая в 08:07

КРОЛИКУ ОПЯТЬ ПРИШЛИ ЗАМЕЧАНИЯ! 🐰

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

Лена Черных, наш технический писатель, описала на, как создаёт скринкасты и видеоролики по работе Directum, которые не гасят в пользователях едва теплящееся желание разобраться в новом ПО.

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

А причём тут кролики? 🤔

Читать
Directum | Про Slack и синхронизацию режимов сна

Про Slack и синхронизацию режимов сна

23 апреля в 13:55

Недавно состоялся душевный разговор с руководителем Отдела интеллектуальных механизмов Игорем Беляком. Поговорили о том, как строится работа в отделе, про новые правила, дресс-код и котенка по имени Пиксель.

Читать