¿Por qué a los buenos programadores no les gusta documentar?

¿Por qué a los buenos programadores no les gusta documentar?

La respuesta es bastante más sencilla de lo que parece. Los buenos programadores documentan mientras programan, y utilizan otros programas para generar documentación en un formato dinámico, como HTML (lo que estás leyendo ahora). Un ejemplo famoso es doxygen.

El problema viene con los puñeteros formatos: Te falta el logotipo, aquí en negrita, no empieces secciones en medias páginas, y lo peor de todo, utiliza un formato privativo de cierta corporación. Además, para los analfabetos informáticos, la documentación generada no es buena, solo porque no la entienden, es demasiado técnica, por eso hay que escribirla a mano en varios archivos de tal modo que para entender algo tengas que leerlos y recordarlos todos, y como no hay enlaces entre ellos (recordemos que ese programa se pensó para sustituir a las máquinas de escribir, no a la documentación dinámica) se inventan formas antediluvianas para intentar paliar esa carencia, haciendo todo mucho más complicado de lo que debiera. Por eso no gusta documentar, porque la mayoría es pura morralla que no sirve para nada. Ni siquiera para poder desplegar desde cero a partir de los repositorios de código fuente.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

1984 más cerca

Según la prensa internacional, el actual gobierno español está preparando una ley sacada de la novela 1984 para hacer que los opiniarios (televisión, radio y prensa escrita) y aquellos que tienen muchos seguidores deban publicar la versión "verdadera" de los hechos. Por supuesto, la versión "verdadera" la impone el gobierno, igual que en la novela.

Lo que hay que darse cuenta es que hablar de los que hacen mal las cosas (recordemos que para ser político solo se exige saber leer y escribir) da mucho juego, ya sea porque una vez más lo hacen mal o porque se ha producido un milagro y han hecho algo bien. Por eso yo recomiendo vivir en paz y no prestar atención a lo que no podemos controlar (su mal hacer).

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

¿Por qué esperar que las administraciones públicas respondan rápidamente?

Es de ilusos esperar que las administraciones públicas respondan rápidamente ante desastres.

Porque es imposible gracias a la burrocracia. Para empezar a mover algo primero hay que rellenar cientos de formularios que tienen que aprobar las autoridades (in)competentes pertinentes, y si se olvidan rellenar alguno (porque esté publicado que tienen que rellenarlo en una galaxia muy muy lejana a la que nadie tiene acceso), una administración pública multa a otra administración pública. 

Otro ejemplo claro son las ayudas a La Palma (Santa Cruz de Tenerife). por el volcán Cumbre Vieja: 

Un año y medio hasta que sale en el BOE que se lo distribuyen a la diputación

Otro año hasta que la diputación decide como repartirlo...

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

El algoritmo más sencillo, rápido y seguro para realizar búsquedas en SQL

Quieres buscar por múltiples campos. Este algoritmo es el más sencillo, rápido y seguro.

Realizar una búsqueda enlazando las condiciones con AND solo con los campos que tengan contenido válido en la petición.

1. Comprobar que quien ha realizado la petición tiene permisos para realizarla.
   
2.  Como siempre, validar que los campos son o vacíos o solo contienen letras, dígitos o comodines (? y * como en Linux, o _ y % como en SQL).
3. Preparar la consulta, con los campos no vacíos, en la forma 'campo = ?', transformando los nombres de los campos recibidos a los campos de la BBDD, y si hay algún comodín, transformando el = en like, y si se ha elegido la forma Linux, cambiar a la forma SQL).
4. Ejecutar la consulta preparada
   
5. Filtrar los resultados que puede ver quien haya realizado la consulta y devolver los resultados.
   

 

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Signal, WhatsApp y Telegram pueden leer tus mensajes, si quieren.

No hay que dejarse engañar por especificaciones técnicas complejas y muchas opiniones sin base técnica. Es mucho más sencillo.

Si se pueden leer los mismos mensajes en varios dispositivos, los servidores de Signal, WhatsApp y Telegram u otros atacantes también lo pueden hacer, si quieren, y sin que te enteres. Porque las claves para descifrar los mensajes hay que intercambiarla de algún modo entre dispositivos, y la forma más sencilla es a través del servidor.

Si estoy equivocado, que alguien me corrija, pero con fundamento.

Una evidencia a favor: https://www.scribd.com/document/843124910/NSA-full

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Linux es más sencillo de utilizar que Windows o Mac

Abreviaturas: W$ = Windows, Mac = iOS

Instalación:

• Si ya viene instalado, Linux es igual de complejo de instalar que W$, es decir, nada.
  
• Si solo quieres tener Linux (la única opción de W$), es mucho más rápido (20 minutos con todo actualizado) y sencillo de instalar que el W$ (más de 1h y muchos reinicios después).

Recién instalado:

• Una vez instalado, en Linux tienes programas con interfaz gráfica para hacer de todo.
• Un W$ recién instalado sirve para muy poco. Los Mac traen algún que otro programa.

Interfaz gráfica:

• La consistencia y personalización de la interfaz gráfica de Linux (especialmente la de KDE) supera con creces a las miles de variantes de W$.
• El diálogo para seleccionar ficheros de KDE en Linux es el mejor que he visto hasta ahora.
• Tienes varias alternativas para el menú inicio en Plasma de KDE, pero siempre los programas están clasificados, una ventaja sustancial frente a la lista del W$ o Mac.

Línea de comandos:

• Si alguien tiene que utilizar la línea de comandos, comprobará que la de Linux y Mac (BSD) le dan cien mil vueltas a la de W$ (incluso a la nueva terminal). Y también se puede comprobar que es muchísimo más útil, las pocas veces que hace falta.

Seguridad:

• La seguridad de Linux y Mac es muy superior a la del queso suizo del W$. Mira que miles de empresas llevan años intentando conseguir que el W$ sea casi tan seguro como un Linux o Mac (BSD), y no lo consiguen.

Velocidad:

• Cualquier programa funciona de 2 a 20 veces más rápido en Linux o Mac que en W$.

Solución de problemas:

• En Linux tienes mensajes de error que describen cual es el problema, y a veces las posibles soluciones.
• En W$ solo tienes el famoso mensaje "Ha ocurrido un error".
• Para Linux, buscando en internet encuentras la solución. ¿Qué solución puedes encontrar al Ha ocurrido un error?

 Programas disponibles:

• La inmensa mayoría de los programas que se desarrollan para Linux también funcionan para Mac o W$. Al revés no.
• Hay muchísimos programas libres y gratis, que igualan o superan a los privativos de W$ o Mac.

 

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

 

 

 

La tasa Microsoft a los profesores

Abreviaturas: M$ = Microsoft, W$ = Windows, O$= Office

Ya me he encontrado demasiados profesores y maestras que deben pagar la nada barata tasa mensual de M$, porque ya sea el ministerio, su colegio, el desconocimiento u otro tipo de presión les obligan a moldear la información en los formatos privativos del O$. Sí, M$ tiene una ISO, por la que hay que pagar para leerla, y que ni siquiera M$ es capaz de implementar correctamente.

Primero, ni el ministerio, ni los colegios, ni el desconocimiento ni otro tipo de presión les deberían obligar a utilizar ese formato, habiendo un formato totalmente libre, como es que utiliza LibreOffice, y que M$ implementa incorrectamente para forzar a utilizar su formato.

Aun así, existen programas libres que leen y escriben los formatos del O$ casi tan bien o mejor que el O$, tanto para W$, Linux o Mac y no hay que pagar el impuesto M$ cada mes.

Uno de ellos es Only Office, https://www.onlyoffice.com/es/

Y otro es LibreOffice, https://es.libreoffice.org/,  que cada día se acerca más a mostrar y escribir bien los formatos O$, es el estándard de los formatos OpenOffice, y además fue el primero que utilizó python como lenguaje de programación para personalizar documentos, y 15 años después M$ les ha copiado.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Por qué no se ha vuelto a la Luna

Una de las principales causas puede ser la invención del Procesador de Texto.

En la mayoría de las empresas y administraciones públicas, lo más importante ha pasado de ser el contenido al continente. Si esto no está con un color determinado, o no es una tabla, o no sigue la plantilla, o no está centrado, o ....

Ojalá los Procesadores de Texto aprendan algo de las hojas de estilo CSS, y cambiar todas esas cosas fuese tan sencillo como cambiar el CSS.

Pero no, se pierden muchísimas horas para poner "en bonito" incluso el mensaje más sencillo, porque si no están en el formato que sabe leer cierto Procesador de Texto, algunos ni siquiera lo leen (o eso dicen).

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Para eliminar muchísima publicidad de los móviles y del navegador

Para quitar muchísima publicidad de los móviles, se pueden seguir los pasos descritos en el método 2 de:

https://adguard-dns.io/en/public-dns.html

Y, para quitar muchísimos anuncios de los navegadores, se puede instalar la extensión o plugin o plug-in o como quiera que lo llamen, con el nombre "ublock origin".

https://ublockorigin.com/

Espero que disfruten de una vida sin menos publicidad.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Los comentarios del código fuente

Un código bien comentado no solo te es útil a ti mismo cuando lo leas dentro de 3 meses o más, también para los demás. 

Al igual que cuando se resuelve un problema hay que describir en texto cada paso seguido, para poder saber  el razonamiento utilizado y poder comprobar si es el correcto, lo mismo hay que hacer cuando se resuelve un problema con cualquier lenguaje de programación.

Un código hay que comentarlo como si fuese algo nuevo o algo que no recuerdas, especialmente si al leerlo te haces alguna de las siguientes preguntas: ¿Cuando se utiliza esto? ¿Por qué se utiliza esto? ¿Cómo lo hace?

Para conseguirlo, dos opciones:

* Cuando se está empezando y se llena todo de TODO: (hay que hacer esto) y FIXME: (arréglame). Cuando se finalice cada uno de ellos, convertir el TODO o FIXME en un comentario normal.

* Cuando se ha acabado, haz como si tuvieras memoria de pez y lee el código de nuevo, o espera a que se te olvide (alrededor de 3 meses) y léelo entonces.

En cuanto te hagas a ti mismo una pregunta sobre el código, apúntala, esa pregunta necesita un comentario. O si programas con otros, que otros lean el código y si se hacen alguna pregunta, esa pregunta necesita un comentario.

Y si cuando vuelvas a leer el código con los comentario te siguen quedando dudas, mejora los comentarios.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

El matar se va a acabar

Cuando una persona mata a otra la llaman asesino.

Cuando una persona mata a unas pocas la llaman terrorista.

Cuando una persona pide a otros que maten a personas de otros países, les llaman presidentes del gobierno o dictadores.

¿Algún día aprenderán a no hacer caso a un descerebrado esas personas a las que les piden que maten a otros?

Alguien me tildará de simplista, y puede que tengan razón, porque es muy simple hacer una ley que impida que esta situación se pueda dar. Y también es muy simple intentar colarla, como ya intentó la Unión Europea.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

La mala fama de los CGI (web)

La mala fama de los programas Common Gateway Interface (CGI) como forma de procesar programáticamete las peticiones web, se debe principalmente al entorno inoperativo de cierta corporación, que al ser incapaz de mantener en memoria los ejecutables para no realizar un proceso bastante costoso cada vez que se inicia un programa (solo lo hace con las librerías dinámicas), hace que los CGI en su porquería sean muchísimo más lentos que en cualquier otro sistema operativo.

Así que se idearon otras formas de mantener los programas en memoria y aparecieron los servidores de aplicaciones, donde el servidor decide qué librería, que se mantiene siempre en memoria, debe procesar cada petición, le pasa la petición y esta devuelve la respuesta. Así se conseguía reducir la diferencia abismal de rendimiento con los otros entornos.

La versión moderna del servidor de aplicaciones es el conocido como "serverless", donde cada programa tiene su propio servidor. Ahora no se tiene un único servidor y múltiples librerías, ahora se tienen múltiples programas (lo que antes era una librería), cada uno con su servidor. Ahora es el Sistema Operativo el que gestiona las colas de las peticiones en lugar del servidor de aplicaciones.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

La única regla para simplificar ecuaciones

La única regla válida para simplificar ecuaciones donde hay igualdades es muy sencilla:

Si las dos partes son iguales, si se hace lo mismo en las dos partes, la igualdad se mantiene.

Es decir, si A=B entonces f(A) = f(B), siempre que f no devuelva un resultando indefinido como infinito o -infinito, por ejemplo por dividir por 0.

Por ejemplo:

3(x² + 8)=3x(x² + 8)

Empezamos con el paso sencillo: Quitar los paréntesis

3x² + 24=3x³ + 24x

Ahora sí, en lugar de usar reglas mnemotécnicas del estilo: la suma se pasa al otro lado restando, si queremos pasar un término al otro lado, simplemente le restamos su negativo en ambas partes, para así tener un 0 en una parte. La multiplicación se pasa al otro lado dividiendo (siempre que no sea 0), es simplemente dividir en ambas partes por lo mismo para mantener la igualdad.

3x² + 24 - 3x³ =3x³ + 24x - 3x³

Que se transforma en:

- 3x³ + 3x² + 24  = 24x

Lo mismo con 24x:

 - 3x³ + 3x² + 24 -24x = 24x - 24x

 - 3x³ + 3x² - 24x + 24 = 0

 -3(x³ - x² - 8x + 8) = 0

-3(x-1)(x²+8)=0

Y entonces sabemos que si x-1=0 o x²+8=0 la ecuación se cumple, es decir, las soluciones son:

x=1

x=(-8^1/2) que tiene dos soluciones: x=2(2^1/2)i y x=-2(2^1/2)i

Esto solo sirve para la igualdad entre números complejos o reales, no para la igualdad de la aritmética de módulo, ya que cambian completamente las reglas.

Una lástima que no hagan lo mismo con el spam legalizado por un subnormal

Un juez español quiere que los proveedores de Internet españoles bloqueen Telegram a través del gran cortafuegos español, el mismo que ya utilizan para bloquear muchas páginas web, y que hace imprescindible la comunicación mediante conexiones cifradas https o vpn + https para mantener algo de privacidad.

Si son capaces de bloquear un programa de mensajería instantánea, también son capaces de saber quien está realizando llamadas SPAM y les pueden bloquear o quitar la línea telefónica.

Señores jueces, hagan algo bueno por los españoles, no solo por unas pocas empresas que ya ganan demasiado. ¡Ah!, que necesitan que alguien haga una denuncia para mover un dedo, se me olvidaba ese pequeño detalle.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Cómo conseguir esa ansiada igualdad entre hombres y mujeres

Los primeros que tienen que dar ejemplo son las administraciones públicas.

Si se elimina el sexo del DNI y de todos los formularios, se acabó la discriminación de las administraciones públicas por razón de sexo, que las hay, y además por ley (discriminación positiva).

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.

Hay algo más complejo que los problemas No Polinómicos, los problemas creados por los Funcionarios.

Los Funcionarios de escritorio asignados a la creación de programas son especialistas en crear problemas, como:

• Poner campos calculados en una Base de Datos, violando la 1ª forma normal y haciendo que sea casi imposible la integridad referencial, y no hay forma de bajarles de la burra (que eso es mucho peor).
  
• Utilizar más de una clave para un mismo dato.
• Crear cientos de copias de lo mismo en lugar de sustituir.
• Utilizar programas antediluvianos de cierta corporación.
  
• Cambiar de opinión cada día. Esto hace que cualquier cosa que pudiera parecer sencilla se enmarañe hasta ser incomprensible.
  
• Utilizar el desarrollo por documentación (lo más importante es la documentación, no los programas obtenidos).
• Se pierden en minucias en lugar de ver todo el conjunto.
  

El problema más complejo del mundo es conseguir hacer algo decente con Funcionarios. Así es normal que se tarde diez veces más de lo normal en hacer cualquier cosa.

Copyleft Ender. El presente artículo no tiene finalidad informativa, de creación de opinión pública o de entretenimiento. Tiene como finalidad principal, la enseñanza y la divulgación de experiencias, proyectos, pensamientos y conocimientos del autor. Se permite la copia textual, la traducción y la distribución de este artículo entero en cualquier medio, a condición de que este aviso sea conservado. Se permite la cita. El autor no reclamará ninguna cantidad por el ejercicio de las dos autorizaciones anteriores. No autorizo a ninguna Entidad de Derechos de Autor a reclamar cantidad alguna en mi nombre por el ejercicio de los dos derechos anteriores.