What's the main advantage of generating OpenAPI docs from annotated code (springdoc-openapi) versus hand-writing a spec file?

Hand-written specs inevitably drift out of sync as the code evolves, since nothing forces them to stay updated. Annotation-driven generation (`@Operation`, `@Schema`) derives the spec directly from the actual controller code at build/runtime, so the documentation can never describe an endpoint shape that doesn't match reality.