CI quality gate
Combina check, coverage y lint en un único job para fallar los PRs que degraden la documentación.
Job de ejemplo
yaml
- name: Docs quality gate
run: |
npx nestjs-docfy check
npx nestjs-docfy coverage --min 90
npx nestjs-docfy lintcheck falla si algún controller marcado con @WithDocs() no tiene archivo companion o tiene métodos añadidos desde el último generate. coverage --min 90 falla el build si menos del 90% de los endpoints está documentado. lint juzga la calidad de lo que ya está documentado: summary faltante en ApiOperation, endpoints con @Body() y sin respuesta 400, y ApiBody sin descripción. Cualquiera de los tres comandos sale con código 1 cuando encuentra problemas, lo que falla el pipeline.