АХ
Хорошо, тогда попробую с другой стороны. Есть ли какие-то стандарты или что-то вроде, которые бы регламентировали написание Е или Ё?
Size: a a a
2017 March 31
AY
Хорошо, тогда попробую с другой стороны. Есть ли какие-то стандарты или что-то вроде, которые бы регламентировали написание Е или Ё?
вроде как нет
АС
Учебник по русскому языку
NV
Как вы сами решите и напишете в стайлгайде для своей команды, так и будет. )
АХ
Как вы сами решите и напишете в стайлгайде для своей команды, так и будет. )
В этом то и проблема) Мнения разделились и никто особо не хочет уступать
АГ
В общем на вкус
SS
Если текст в интерфейсе, то пишу Ё, если в документации по ГОСТ - нет, если в маркетинговом тексте —пишу. Использование Ё - это вопрос стиля текста
NV
Неужели ГОСТ не велит писать Ё?
ND
У нас больше - это как скажет руководство
ND
😆😆😆
AK
Всем привет! Какие best practices для документирования API посоветуете? Чаще всего ситуация от проектирования API, разработки до поддержки в будущем.
AY
Всем привет! Какие best practices для документирования API посоветуете? Чаще всего ситуация от проектирования API, разработки до поддержки в будущем.
только что закончил писать документацию API с помощью Swagger
NV
недавно обсуждали вроде. Для REST API отлично подходит swagger.io
AK
Swagger да, пробовал, не совсем нравится в нём то, что все автосгенерированное и документация без души.
AY
недавно обсуждали вроде. Для REST API отлично подходит swagger.io
+1
NV
почему автосгенерированное? Пишите самостоятельно, никто не запрещает.
NV
Можно вообще открыть пустой файл в блокноте и с нуля писать.
AK
Пробовали на небольших проектах API Blueprint и RAML, тоже хорошо, но возникает проблема в поддержке актуального состояния, разработчики ленятся.
AK
Возможно не до конца прочувствовал swagger :)