Cómo hacer buenas preguntas como desarrollador

Imagen Camylla Battani | Unsplash

Saber hacer preguntas de la manera correcta es una habilidad clave para la vida en general. Una pregunta bien estructurada, la mayoría de las veces, devolverá una respuesta útil y directa.

Cuando se trata de codificación, hay algunos pasos que puede seguir para aumentar las posibilidades de obtener una buena respuesta.

Entonces, una de las habilidades que trato de mejorar con mis alumnos en clase es cómo hacer buenas preguntas cuando se encuentran con un problema.

Aquí están los puntos principales que les enseño:

Hacer lo básico

Los primeros elementos en su buena pregunta-pregunta-búsqueda () son los conceptos básicos.

En las primeras lecciones de un curso en persona, un instructor puede guiarlo a través de la solución, mientras arregla su código. Pero, en el gran mundo malo de las comunidades en línea, no hacer al menos lo básico a menudo es como una bandera roja para un toro.

Revise su editor de código para errores tipográficos y de sintaxis

El resaltado de sintaxis es un poderoso aliado al detectar errores tipográficos simples.

Especialmente para cualquier británico por ahí:

En los primeros días, la mayoría de sus errores serán errores tipográficos y de sintaxis. Estos deberían ser una solución rápida con la ayuda de su editor de código de confianza.

Verificar errores escritos

Si el idioma que está escribiendo contiene errores escritos, verifique la consola / registros. Lea el error para ver qué y dónde está el error.

Intenta entender lo que está pasando

Una vez que hayas hecho lo básico, estarás un poco más informado sobre cuál podría ser el problema.

Ahora es el momento de leer el código línea por línea. Utilice las herramientas de depuración disponibles para el idioma y profundice en el problema.

Tómate tu tiempo aquí. Cuanto más comprenda el problema, más hipótesis puede crear. Esto, a su vez, conducirá a una pregunta más clara.

Si se trata de un problema de interfaz de usuario (UI), use las herramientas de desarrollador de su navegador. Active y desactive estilos y vea cuáles están siendo sobrescritos por otros.

De lo contrario, use depuradores e inspeccione los valores de las variables. ¿Son lo que esperabas? ¿Algo se muestra como indefinido cuando esperas que tenga un valor?

Si es necesario, comente los bloques de código para determinar dónde está el problema.

Haz algunas búsquedas en Google

Por ahora, al menos debería tener una comprensión del problema. Esto significa que debería poder estructurar una pregunta enfocada. Antes de pedir ayuda a alguien más, dirígete a Google para realizar algunas búsquedas.

Google es el mejor amigo de un desarrollador. Incluso los desarrolladores experimentados necesitan salir de problemas de Google de forma regular. Los buenos desarrolladores también son, muy a menudo, buenos Googlers.

La forma básica de estructurar una consulta decente de Google es la siguiente:

enumere el idioma, la biblioteca o el marco, luego agregue su pregunta de palabra hablada O mensaje de error

Aquí hay un par de ejemplos de preguntas que se hacen siguiendo esta estructura:

Asegúrate de hacer algunas búsquedas diferentes. Lea los resultados que parezcan apropiados para su problema. Con un poco de suerte, alguien antes de usted habrá tenido el mismo problema y habrá resuelto su problema.

Recrea el problema lejos del proyecto

Si aún no ha solucionado su problema, intente recrear el problema lejos del proyecto. Esto es especialmente útil si enfrenta algún problema extraño de CSS. En este caso, puede dirigirse a algún lugar como CodePen y compartir su fragmento de código roto.

Ser capaz de separar su código roto del resto de su proyecto tiene un par de beneficios:

  • Te ayudará a concentrarte en el tema
  • Ayudará a cualquier persona que se involucre a solucionar el problema más rápido.

Esto vuelve a valorar el tiempo de otras personas. Les llevará menos tiempo pasar por un fragmento de código sucinto que toda su base de código.

Prepárate para compartir tu código

De acuerdo, no ha podido solucionar el problema usted mismo. ¡Sin preocupaciones! Todo lo que ha hecho hasta ahora ha sentado las bases para poder hacer una gran pregunta.

Pero, antes de traer a alguien más para que lo ayude, hay un par de cosas que hacer:

1) Asegúrese de que su código esté bien formateado

Si eres un desarrollador disciplinado, que tiene un código bien formateado, entonces choca los cinco

Si no lo eres, ahora es el momento de que tu código se vea impecable .

Considera usar linters. Linters imponen buenas prácticas al emitir advertencias / errores para código mal formateado. Incluso puede hacerlo para que no pueda insertar código que tenga errores de linting.

Como mínimo, agregue Prettier a su editor y deje que haga el formato por usted.

La conclusión es: nadie quiere resolver el formato de su código antes de que puedan comenzar a ayudarlo.

2) Asegúrese de que el código que está compartiendo recrea el error

Antes de compartir su código, asegúrese de que recrea el problema que está experimentando. Esto debería ser evidente, pero será extremadamente difícil ayudarlo si el código que está compartiendo no recrea el error.

Si el código requiere algunos pasos para comenzar a funcionar, asegúrese de incluir esos pasos cuando comparta el código.

Muestra los esfuerzos que has realizado para resolver el problema.

En este punto, estás levantando la mano en el aula o dirigiéndote a algún lugar como StackOverflow o un canal Slack para obtener una respuesta en línea.

Al preguntar, es crucial seguir los pasos que ha tomado hasta ahora para resolver su problema. Proporcione a cualquier persona que pueda ayudarlo con la mayor cantidad de información posible para aclarar su problema.

Aquí hay algo de la información que debería compartir:

  • Tu comprensión del problema. Esto podría ser algunas hipótesis diferentes por ahora. Es importante que articule cuál cree que podría ser el problema y qué ha hecho para intentar solucionarlo.
  • Capturas de pantalla de su problema / error. Si se trata de un problema de IU, anote su captura de pantalla para resaltar el problema.
  • Código (preferiblemente en un entorno de espacio aislado) que recrea el problema.

Lea y vuelva a leer su pregunta, si publica en línea. Asegúrese de proporcionar tantos detalles como sea posible para ayudar a otros a ayudarlo.

Una pregunta vaga es mucho más lenta de responder en línea que en persona.

Mantenga a todos actualizados

Si ha publicado la pregunta en línea, puede resolver su problema antes de que alguien más tenga tiempo de responderla. Si este es el caso, asegúrese de publicar su propia respuesta a su pregunta.

Puede parecer extraño responder su propia pregunta en línea. Pero la gente lo hace todo el tiempo y podría ayudar a alguien más en el futuro.

Agradece a cualquiera que haya intentado ayudarte

Esta. Es. Crucial.

Gracias a todos los que intentaron ayudarte. Incluso si en realidad no ayudaron a resolver su problema. Se han tomado un tiempo de su día para ayudar a arreglar su código roto. Muestra tu agradecimiento

¿Tiene algún consejo o truco para hacer buenas preguntas que le gustaría agregar? Por favor escríbelos en los comentarios.

¿Quieres decir hola? Sígueme y tuitea @frontendmentor en Twitter.