jsdoc-best-practices

This skill defines the JSDoc documentation standards for this project. The core principle is that documentation should explain "why", not just "what". Code already shows what it does—good documentation explains the reasoning, context, and non-obvious details that help developers understand and maintain the code.

This documentation adds no value—the function name already tells us it gets a user by ID.

The project enforces JSDoc through eslint-plugin-jsdoc with these rules:

Applica gli standard di documentazione JSDoc per questo progetto TypeScript. Questa abilità dovrebbe essere utilizzata durante la scrittura o la revisione del codice TypeScript per garantire una documentazione adeguata con preamboli di file, documenti di funzioni, documenti di interfaccia e la distinzione critica tra documentare "cosa" e "perché". Utilizza questa competenza per comprendere le regole JSDoc ESLint del progetto e i modelli stabiliti. Fonte: codyswanngt/lisa.