I am a cloud application architect with 10 years' experience in software development in several languages, including Perl, Java and C#. I'm an Irishman living in Calgary, Canada. GitHub on @cubikca.
Location
Calgary, Canada
Education
BSc. Computing and Info Systems, Athabasca University
Those external comments are used to generate OpenAPI documentation using Swagger.
Yes I agree, it does make sense to comment code to expose documents to others. I would consider this a non-functional requirement.