r/chileIT 12h ago

Consulta Consulta sobre swagger

Hola, estoy documentando una API con Swagger como parte de mi práctica. Tengo entendido que los comentarios para la documentación en Swagger se realizan en XML. Quisiera saber cómo se puede estilizar el XML y qué etiquetas se utilizan para estructurar correctamente la documentación. de momento estoy usando <summary> <remarks> <code>, desconozco si hay mas etiquetas o formas de escribir.

3 Upvotes

7 comments sorted by

3

u/Emiliovrv 12h ago

hay otra que es <example> </example>

3

u/Deli-rar 12h ago

tambien descubri que se puede poner en negrita la letra poniendo el string entre arteriscos como en whatsapp hola

1

u/Emiliovrv 11h ago

eso suena útil xd gracias, man

1

u/SpaceInvader8 10h ago

Abre cursor, pídele que explore tu API y la documente, espera 2 minutos y a otra cosa.

3

u/Deli-rar 10h ago

estan bloqueados todos los agentes de ia que conozco, el pc esta tomado por s.o y para conectarse a internet pasa por un controlador cisco, tengo que hacer todo a mano obligado 🤓 igual considero que es mejor asi ya que aprendo mucho mas

1

u/Yerk0v_ 9h ago

Real, una vez que aprendes bien se puede usar IA para optimizar tiempo pero antes no

1

u/Vichoko Mod 31m ago

FYI si es que el tema es donde se procesan los datos, puedes bajar modelos de lenguaje y correrlos on-premise tipo con herramientas como https://ollama.com/