Ну скажем у меня код пишется постфакту после планирования того зачем этот метод вообще нужен.
Когда все решено то я описываю что он принимает и что отдает а потом уже пишу код который в итоге не расходится с документацией

Если так думать обо всем то смысл тогда вообще делать документацию и писать какой либо код

Значит не на тот свагер зашел )))

Да, он делает тоже самое — НО!!!
Это JS и значи работы будет еще больше.
Nelmio — это готовый бандл который просто прочтет нужные каменты — а значит будет быстрее
+ его можно заекстендить и расширить /