Используем и для публичных API. Внешнему пользователю обычно нужна HTML версия доки. В ней предстоит еще много доработок, но в текущем виде для моделей данных есть табличный вид, хотя и без него от особенностей jsight там остаются только правила для моделей, которые интуитивно понятны и все равно не имеют общепринятого формы записи.
Code first удобен на маленьких или типовых crud апи. А часто хочется апи сначала спроектировать, а потом уже кодить. Да даже в самом банальном сценарии, где фрон и бэк разрабатываются разными людьми параллельно, лучше иметь четкую спецификацию и получить один туннель вместо двух.
Используем и для публичных API. Внешнему пользователю обычно нужна HTML версия доки. В ней предстоит еще много доработок, но в текущем виде для моделей данных есть табличный вид, хотя и без него от особенностей jsight там остаются только правила для моделей, которые интуитивно понятны и все равно не имеют общепринятого формы записи.
Code first удобен на маленьких или типовых crud апи. А часто хочется апи сначала спроектировать, а потом уже кодить. Да даже в самом банальном сценарии, где фрон и бэк разрабатываются разными людьми параллельно, лучше иметь четкую спецификацию и получить один туннель вместо двух.
По-моему, если топить за грамматику, то стоит учитывать где это метод будет использоваться. If, while..