Comentarios y sugerencias

¿Viste algún problema con alguna lección de The Programming Historian en español? ¿Código que no funciona o que necesita explicaciones más claras? ¿Errores de tipografía? ¿Sintaxis que no parece correcta? Gracias por tomarte el tiempo de advertirnos de un problema o de sugerir un cambio. Tu ayuda es crucial para ayudarnos a mantener los más altos estándares en nuestras lecciones.

Hay varias maneras sencillas de darnos retroalimentación:


Opción 1: correo electrónico o “Tweet”

Contacta a Víctor Gayol, Maria José Afanador-Llach o a Antonio Rojas Castro. Puedes encontrar más sobre el equipo editorial en Equipo de proyecto.

También nos puedes encontar en Twitter en @ProgHist.

Opción 2: inicia un “Issue” en GitHub

Primero, si no tienes una ya,abre una cuenta personal gratis en GitHub. Si ya tienes una cuenta inicia sesión.

Después ve a la página de “issues” de nuestro Repositorio.

Échale un vistazo a los “issues” que están abiertos para ver si el problema que has identificado ya ha sido reportado. Si así es pero tienes más información que quisieras compartir, deja un comentario en ese “issue”.

Si tu “issue” no ha sido reportado, crea un nuevo “issue” con un título descriptivo y con tanta información sobre el problema como te sea posible compartir.

Para más información sobre los “issues”, lee la guía de GitHub en Mastering Issues.

Opción 3: sugiere un cambio específico

Para sugerir o hacer un cambio menor a una lección, primero navega al directorio de lecciones y entra a la lección en cuestión.

Después pulsa el botón de “history”:

Ahora pulsa en el más reciente “commit” para la lección:

Después, para comentar en una línea, coloca el cursor sobre el número de una línea y un signo azul de suma (+) aparecerá; pulsando en este va a abrir una caja de comentarios para esa línea en particular. La línea que necesita arreglarse se puede ocultar; si es así, pulsa en el botón de expandir para mostrar las líneas ocultas.

Los editores serán notificados sobre estos comentarios y pueden después incorporar tus sugerencias en la lección. Aun cuando nos esforzamos por ser abiertos, por ahora, solo los editores de Programming Historian pueden hacer cambios directamente en las lecciones.

Opción 4: haz un “Pull Request”

Si crees que sabes cómo arreglar el problema en la lección, puedes considerar bifurcar (en inglés, “forking”) nuestro repositorio y hacer un “pull request”.

Para más información sobre “pull requests”, visita la guía de GitHub en Forking Projects o el tutorial de Rich Jones sobre How to GitHub.

Más recursos sobre Git y GitHub

Utilizar Git y GitHub puede ser razonablemente simple una vez adquieras práctica. Si estás interesado en aprender más y contribuir, el sitio de GitHub es un buen sitio para empezar.