Skip to main content

Мультиязычная разработка

На данный момент проекты Ensi, Ensi Cloud, Ensi Enterprise находятся в процессе перехода на двуязычную разработку: на русском и английском языках.

Общие правила

  • Любые комментарии в коде: текстовые, phpDoc, описания консольных команд и т.д. должны быть на английском языке. В редких случаях особо сложной логики, допустимо продублировать комментарий на русском языке.

  • Любые тексты логов, исключений, консольных сообщений и т.д. должны быть на английском языке.

  • Все контентные сообщения остаются только на русском языке и будут переводиться на языковые файлы в рамках реализации концепции мультиязычности контента. Тут речь о текстах, попадающих в response: бизнес-логика, ошибки валидации, кастомные исключения, :meta.

  • OAS документация остаётся только на английском, за исключением описаний enum (пока описание enum используется для вывода пользователю, перевод будет в рамках задачи мультиязычности контента).

  • Документация: README.md на github, https://docs.ensi.tech/. Разработчики дополняют документацию только на русском языке, далее будет инициироваться независимый процесс перевода обновлений.