Swagger is typically used to auto-generate nice and interactive API docs automatically, not really meant to be written by hand.