Comentarios sobre la historia
Recode, Reuters, Popular Science, The Week, Mic, The Verge y USA Today’s FTW han cerrado los comentarios de los lectores en el último año. He aquí cómo todos ellos están utilizando las redes sociales para fomentar la discusión de los lectores.
Durante un breve periodo de tiempo a finales de 2014, parecía que los editores habían llegado a un punto de ruptura en su continua lucha con los comentarios de los lectores. Con pocas semanas de diferencia, Recode, Mic, The Week y Reuters anunciaron que cerraban sus secciones de comentarios. Se unieron a otros medios, como The Chicago Sun-Times y Popular Science, que abandonaron la práctica en favor de dejar que los usuarios discutan las historias en los canales sociales.
“Si estuviera pintando un sitio web y al final dijera: ‘Por cierto, al final de todos nuestros artículos vamos a dejar que cualquier avatar con seudónimo haga y diga lo que quiera sin moderación’, si no hubiera una convención de comentarios en Internet, si no fuera algo aceptado, se pensaría que es una idea descabellada”, dijo Ben Frumin, redactor jefe de TheWeek.com.
Ejemplo de comentario sobre la historia del referente cerebral
Evite los comienzos pretenciosos e insulsos. Si estás escribiendo un artículo sobre, por ejemplo, las respuestas británicas a la rebelión de la India en 1857, no empieces con una afirmación como ésta “A lo largo de la historia de la humanidad, los pueblos de todas las culturas del mundo se han enzarzado en muchos y prolongados conflictos sobre numerosos aspectos de la política gubernamental y las cuestiones diplomáticas, que han interesado mucho a los historiadores y han generado teorías históricas en muchos ámbitos”. Esto es pura basura, aburre al lector y es una señal segura de que no tienes nada sustantivo que decir. Vaya al grano. Aquí hay un mejor comienzo: “La rebelión de 1857 obligó a los británicos a replantearse su administración colonial en la India”. Esta frase indica al lector de qué trata realmente su trabajo y le despeja el camino para exponer su tesis en el resto del párrafo inicial. Por ejemplo, podrías argumentar que una mayor sensibilidad británica hacia las costumbres indias era hipócrita.
Tanto si estás escribiendo un ensayo para un examen como un trabajo de fin de carrera, tienes que tener una tesis. No te limites a repetir la tarea o a empezar a escribir todo lo que sabes sobre el tema. Pregúntate: “¿Qué es exactamente lo que estoy tratando de demostrar?”. Tu tesis es tu visión del tema, tu perspectiva, tu explicación, es decir, el caso que vas a argumentar. “La hambruna asoló Irlanda en la década de 1840” es una afirmación verdadera, pero no es una tesis. “Los ingleses fueron responsables de la hambruna en Irlanda en la década de 1840” es una tesis (que sea defendible o no es otra cosa). Una buena tesis responde a una pregunta de investigación importante sobre cómo o por qué ocurrió algo. (“¿Quién fue el responsable de la hambruna en Irlanda en la década de 1840?”) Una vez que hayas expuesto tu tesis, no te olvides de ella. Desarrolla tu tesis de forma lógica de párrafo a párrafo. Tu lector debe saber siempre de dónde viene tu argumento, dónde está ahora y hacia dónde va.
Doctrina de Python
[Nota del editor: Mientras nos tomamos un tiempo para descansar durante las vacaciones y prepararnos para el próximo año, volvemos a publicar nuestros diez mejores posts del año. Por favor, disfruta de nuestros trabajos favoritos de este año y nos vemos en 2022].
El famoso profesor del MIT Hal Abelson dijo: “Los programas deben escribirse para que los lean las personas y, de paso, para que los ejecuten las máquinas”. Aunque puede que haya subestimado a propósito la importancia de ejecutar el código, tiene razón en que los programas tienen dos públicos muy diferentes. Los compiladores e intérpretes ignoran los comentarios y consideran que todos los programas sintácticamente correctos son igualmente fáciles de entender. Los lectores humanos son muy diferentes. Algunos programas nos resultan más difíciles de entender que otros, y recurrimos a los comentarios para que nos ayuden a entenderlos.
Aunque hay muchos recursos para ayudar a los programadores a escribir mejor código -como libros y analizadores estáticos-, hay pocos para escribir mejores comentarios. Aunque es fácil medir la cantidad de comentarios en un programa, es difícil medir la calidad, y ambas cosas no están necesariamente correlacionadas. Un mal comentario es peor que no tener ningún comentario. Como ha escrito Peter Vogel:
Cómo comentar el código en python
En programación informática, un comentario es una explicación o anotación legible para el programador en el código fuente de un programa de ordenador. Se añaden con el propósito de hacer el código fuente más fácil de entender para los humanos, y generalmente son ignorados por los compiladores e intérpretes[1][2] La sintaxis de los comentarios en varios lenguajes de programación varía considerablemente.
A veces, los generadores de documentación procesan los comentarios de diversas maneras para generar documentación externa al propio código fuente, o los utilizan para la integración con sistemas de gestión de código fuente y otros tipos de herramientas de programación externas.
Los comentarios en bloque delimitan una región del código fuente que puede abarcar varias líneas o una parte de una sola línea. Esta región se especifica con un delimitador inicial y otro final. Algunos lenguajes de programación (como MATLAB) permiten que los comentarios de bloque se aniden recursivamente unos dentro de otros, pero otros (como Java) no lo permiten[4][5][6].
Los comentarios de línea comienzan con un delimitador de comentario y continúan hasta el final de la línea, o en algunos casos, comienzan en una columna específica (desplazamiento de línea de caracteres) en el código fuente, y continúan hasta el final de la línea[6].