NV
А всякие пред- и постусловия? Переходы между состояниями, если они вдруг есть?
Size: a a a
2019 March 26
NV
Fox Mulder
Да кто читает документацию))
На API обычно приходится читать. Это не GUI, интуиция не поможет
FM
У Меня родилось страшное:
Ну вы знаете, эта документация..
Ну вы знаете, эта документация..
FM
Это тонко правда
DB
А всякие пред- и постусловия? Переходы между состояниями, если они вдруг есть?
Если оно есть — в описании поля со статусами
DB
Я стараюсь сохранять минимальное расстояние между документацией и куском логики, за который она отвечает
DB
Чтобы иметь минимальные шансы что-нибудь забыть поменять
AP
"Возвращает все магазины в округе". Остальную логику — через описание полей, фильтров, моделей...
ну а вот если, например, появилось новое поле или у старого логика поменялась. получается, описание вы не обновите?
DB
ну а вот если, например, появилось новое поле или у старого логика поменялась. получается, описание вы не обновите?
Описание — "Возвращает все магазины в округе". Если я добавлю новое поле — оно автоматически появится в сваггере
AP
И непонятно будет, что оно и зачем :)
DB
Почему?
DB
Эта штука регулируется на уровне линтеров — у нового поля обязательно должно быть описание
DB
свой код не покажу, а чужой — пожалуйста
ДС
Fox Mulder
Я даже в личный кабинет заходил
в личном кабинете есть запись о мероприятии, id и "Вы зарегистрированы"
FM
Аналогично, но означает ли это доступ к конференции или это просто регистрация в кабинете
ДС
выглядит так, думаю, речь о мероприятии, а не регистрации в лк
FM
Ага, все так же
FM
Вот надо было так: сяпки) вы зареганы на проконтент. Ждём вас 4 апреля. Интересные доклады, снеки и шампанское вдова клико ждут вас.
ДС
Нет у них такого техписателя, как вы, поэтому все так кратко и про вдову клико никто не пишет