Е
А читать код по спеками и доками намного удобнее
Скажем так. По спекам можно сгенерить доки, которые удобно читать. Да
Size: a a a
2020 August 24
ŹR
Из-за error тупла вообще никогда не знаешь, придёт entity или {ok, entity}
Е
Голые спеки в коде читать муторно. Разве что самые примитивные.
IS
К тому же, с аргументом, который привел @Virviil довольно сложно спорить — как понять, что возвращает функция без спек, не глядя в код?
ŹR
В доке словами написать можно «функция возвращает блабла»
Е
К тому же, с аргументом, который привел @Virviil довольно сложно спорить — как понять, что возвращает функция без спек, не глядя в код?
Я привел ответную аргументацию:
В спеках написано, что функция возвращает
В спеках написано, что функция возвращает
options, что это тебе даст? Нужно еще копаться в доках или коде чтобы расшифровать этот optionsT
А в доках еще по возможности писать доктесты
омг
ŹR
Ну и разницы, если есть формальный язык
Е
омг
Я заценил доктесты - крутота.
ŹR
Я привел ответную аргументацию:
В спеках написано, что функция возвращает
В спеках написано, что функция возвращает
options, что это тебе даст? Нужно еще копаться в доках или коде чтобы расшифровать этот optionsНу опять же, прямая аналогия с названия функции - к примеру функция называется get_user. Все равно надо доку читать - откуда get
ГК
Особенно если первый параметр какой-то
connT
Из-за error тупла вообще никогда не знаешь, придёт entity или {ok, entity}
Принимаешь для себя и своих коллег такой простой контракт: делаете различия между функциями с окончанием на ! и без него.
ŹR
Правда если запустить mix doc, то по спекам гиперссылки херачатся - очень удобно
ŹR
Принимаешь для себя и своих коллег такой простой контракт: делаете различия между функциями с окончанием на ! и без него.
Расскажи это создателям экто
T
К тому же, с аргументом, который привел @Virviil довольно сложно спорить — как понять, что возвращает функция без спек, не глядя в код?
как-то в рубях это делают уже десяток лет, и живут
T
Расскажи это создателям экто
у них с этим всё плохо, но ты же можешь лучше)
Е
Правда если запустить mix doc, то по спекам гиперссылки херачатся - очень удобно
Вот это верно. Спеки хороши для генерации доков. Тут согласен.
Е
А в коде они страшны
T
А в коде они страшны
++
Е
Короче, уточню немного. Если не генеришь доков и/или не используешь диалайзер от спеков мало толку.