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:

Обеспечивает соблюдение стандартов документации JSDoc для этого проекта TypeScript. Этот навык следует использовать при написании или проверке кода TypeScript, чтобы обеспечить правильную документацию с преамбулами файлов, документацией по функциям, документацией по интерфейсу, а также критическим различием между документированием «что» и «почему». Используйте этот навык, чтобы понять правила и установленные шаблоны проекта JSDoc ESLint. Источник: codyswanngt/lisa.