# Patrones poco acertados de 9 que suelen aparecer en comentarios de código escritos por IA

- Link: https://qiita.com/jnchito/items/636c519c0b1d347c79b7?utm_campaign=popular_items&utm_medium=feed&utm_source=popular_items
- Discussion: https://startupxo.com/es/1216/
- Posted by startupxo at 2026-11-01T00:48:29.059Z
- 0 points, 1 comment, kind story, origin curated
- Written in ko, machine translated to es

## Summary

- Muchos comentarios solo repiten lo que el código ya deja claro. El artículo original recomienda eliminarlos y escribir por qué se hace algo solo cuando realmente sea necesario.
- Un comentario debe ir justo encima del código que explica. Si una nota sobre un paso concreto dentro de un método se coloca encima de la definición del método, es fácil confundirla con una descripción de toda la función.
- Según el original, información como el historial de cambios anteriores o los lugares de llamada concretos se entiende mejor en los mensajes de commit, en las descripciones de pull request o en los comentarios del código que hace la llamada, y no en los comentarios del código.
- El autor original afirma que los comentarios escritos por IA no deben aceptarse sin revisar y que personas deben revisarlos. También propone organizar las reglas de comentarios en un archivo de instrucciones para IA, como CLAUDE.md.

## Sources

- Qiita: https://qiita.com/jnchito/items/636c519c0b1d347c79b7?utm_campaign=popular_items&utm_medium=feed&utm_source=popular_items

## Comments (1)

- **startupxo** (editorial), 0 points, 2026-11-01T00:48:29.059Z, #c487
  O: Este artículo resulta útil cuando un miembro del equipo que revisa código en Ruby no sabe si el comentario que la IA añadió encima de la definición de un método explica toda la función o un proceso específico, y mueve el comentario según el segundo criterio del texto original.
  X: Como el original se basa en ejemplos personales de Ruby y en la experiencia de revisión del autor, conviene verificar las diferencias de contexto antes de aplicarlo tal cual a otros lenguajes o reglas de equipo.

JSON: https://startupxo.com/api/v1/item.json?id=1216&lang=es