Centro de ayuda:
Principalmente basada en opinión - las discusiones enfocadas en
opiniones diversas son buenas, pero ellas no encajan bien en nuestro
formato.
Muchas buenas preguntas generan un grado de opinión basado en la expertiz, pero las respuestas a esta pregunta tenderán a ser en su
mayoría enteramente basadas en opiniones, en lugar de hechos,
referencias o expertiz específico.
Lo anterior también aparece en el centro de ayuda de Code Review y ello no les impide que el sitio funcione. Si ellos pueden nosotros también.
La revisión de código encaja por tanto bien en el modelo de SOes y no es necesario elminar ese motivo de cierre para esas preguntas.
Para promocionar este tipo de preguntas sugeriría editar la etiqueta revisión-de-código para guiar al usuario que la usa.
Propongo pues esta descripción de etiqueta basada en la descripción actual y en Code Review e invito a editarla hasta alcanzar un consenso:
Revisión de código es la examinación sistemática (como en la revisión por pares) del código fuente de un programa informático para mejorar la calidad del código, mediante la detección temprana de errores en el código de los programas o alternativas más eficientes a la implementación inicial.
¿Cómo hacer una buena pregunta?
No preguntes sobre código que no funciona, código hipotético o código que no existe. Esas preguntas serán cerradas como no relacionadas.
Si tienes una pregunta de programación que no comple esos requisitos entonces no es apropiada para esta etiqueta. Quizás puedas preguntarla en otra etiqueta o sitio.
El título de la pregunta.
Anuncia lo que hace tu código en el título, no lo que te preocupa acerca del código. Se descriptivo e interesante, atraerás más visitas a la pregunta.
He aquí algunos ejemplos de títulos inaceptables por ser muy genéricos.
- ¿Cómo hago más rápido este código? (A todos nos gusta que nuestro código sea rápido. Puedes usar la etiqueta rendimiento para indicar este deseo.)
- ¿Cómo simplifico esta cadena de condicionales?. (Esto aplica a demasiadas preguntas.)
- Necesito refactorizar esta función de Ruby. (Son los revisores los que aconsejarán si hay o no que factorizarla. No pidas esto en el título.)
- ¿Es esto un buen diseño orientado a objetos? (Muchísimas preguntas podría tener este título. No ayuda a diferenciar la pregunta.)
- Una evaluación online dice que he excedido el tiempo límite. (Demasiado genérico también.)
Además, elimina frases supérfluas similares a las siguientes, puesto que aplican a la inmensa mayoría de preguntas de esta etiqueta:
- ¿Pueden evaluar mi …
- Por favor ayuda en…
- Necesito mejorar esto.
- Reducir la complejidad de…
Debes resumir el objetivo de tu código (qué pretende hacer, no cómo) Algunos buenos ejemplos son:
- Proyecto Euler 9 : Encontrar una tripleta de Pitágoras.
- Juego de la vida con Swing UI.
- Controlador de vista para app de ayuda a dejar de fumar en iOS.
- Validación de entradas para formulario de petición de vacaciones.
Si tu código no tiene un objetivo, entonces es muy probable que tu pregunta contenga código hipotético o que estés preguntando sobre buenas prácticas en general en vez de sobre revisar tu código específico. Esas preguntas están fuera de lugar en esta etiqueta.
Las normas generales de SOes son de aplicación.
Y en esta etiqueta incluir un ejemplo completo, mínimo y verificable es obligatorio, no simplemente muy recomendable. Además el código debe funcionar. Si no funciona puedes buscar ayuda en otras etiquetas.
Asegúrate de incluir en tu pregunta todo el código a revisar; puedes dejar código auxiliar en enlaces en otros sitios. Quita toda información sensible, como contraseñas, pero no alteres tanto tu código que no se asemeje al original.