dev:programming_style
Это старая версия документа!
Рекомендации к стилю форматирования
Язык
Комментарии внутри кода, содержимое Readme и иное - на английском языке.
Текст интерфейса до первого релиза продукта допускается на русском. После релиза - обязательно все основные элементы на английском с русской локализацией.
Описание
Описания репозиториев в git делаются на русском языке, документация на wiki пишется на русском языке, перевод на английский возможен и желателен, но приоритетнее появление документации в целом, чем ее перевод.
Структура репозиториев
- open-web* - набор продуктов, которые предполагают использование на компьютере, а не на мобильном телефоне, соответственно, приоритет нормального вида при верстке - для настольного компьютера или планшета. Но отображение на мобильных должно оставаться функциональным и допустимым, но может быть не очень удобным.
- open-webclient - веб-интерфейс клиента для заказа услуги, для каждого сервиса может быть своим уникальным
- open-init-db - описание структуры БД. Состоит из синхронизируемой части (без изменений для сервиса) и локальной (для каждого сервиса - своя). При этом синхронизируемая и локальная части могут быть под разными лицензиями.
- open-init-services - скрипты для запуска сопутствующих сервисов Open на этапе разворачивания нового сервиса платформы.
dev/programming_style.1657639899.txt.gz · Последнее изменение: 2022/07/12 18:31 — sharixadmin