Documentacion

Para mí, preparar expedientes civiles, penales o documentación de procedimientos de operación es muy similar a documentar BPMN, estándares MOPROSOFT o notas de trabajo internas de código fuente.

En un proyecto de 2006 a 2008 elaboré aproximadamente 150 documentos de notas internas de metodologías seriadas y documentadas.

En el proceso de 2012 en adelante, hasta 2020 durante la pandemia, me parece que llegué al documento número 270, más unos 780 reportes semanales con entre 40 y 60 incidencias semanales de resolución.

Hace unos años hice sistemas que exportaban en formato Markdown para Jekyll y Hugo, con interfaces de documentación. También GitHub lo utiliza, y al documentar procesos externos en GitHub de clientes, me acostumbré igualmente.

Probablemente soy la única persona que conozco que, por reflejo, empieza a usar Markdown en Word.

Hay situaciones que se prolongan por causas de fuerza mayor. En 2008, en el proyecto mencionado, por ejemplo, se negaron a revisar los 96 asuntos de trabajo(cambios solicitados a sistemas) resueltos en un mes para no otorgar la prima de bonificación. En ese caso el acuerdo previo era que cumplir los 25 iniciales era suficiente. Al final fueron 96 y cuando me retiré tuve que deshacer el código de dos puntos  porque para mantenerlos era necesario manejar punteros en C++, no podía dejarlo de ese modo.

En otros momentos me ha pasado que procesos que deberían ser rápidos, míos o de clientes, los juzgados se tardan años a pesar de pruebas legales. En un caso, con un cliente, me tomó tres cambios de jueces para que se realizara una comparecencia. ¿Estaban esperando a que mi cliente se muriera?

El reporte que tengo que acabar hoy es de 1,200 líneas en borrador de Bloc de notas. Una vez que lo pasé a Word, tendré que leerlo y formatearlo para llevarlo a imprimir y entregar mañana a una autoridad. NO es el reporte NIA 230 dereporte de auditoría.

Domingo productivo, pero necesario, porque alguien eligió jugar sucio.

Salgo de mi recámara un momento. El perro de mi hija está echado sobre un mueble, como esfinge. Dos dormidas, otra con su carnaza, paz.

Este no es un asunto de dinámicas de grupos o de leyes. Es de calidad humana y de decencia. Tengo además algo de tiempo libre; no me causa problema usarlo en algo útil. No busco aplausos. Hago lo que quiero hacer, y lo que quiero es lo que debo. Hay momentos en que te dicen qué es lo que quieres… no, eso no aplica en este caso. Lo que quiero siempre será en segundo plano, porque hay algo que es lo moralmente correcto. Escribir esta documentación es parte de lo mismo.

Son las 12:43 aproximadamente. Calculo que serán unas tres o cuatro horas de trabajo duro que debo hacer a ojo y sin inteligencias artificiales. Primero convertir mis notas a un Markdown completo, luego a Word y después editar.

En un tiempo pasé por las metodologías UML Rose Rational, después por los sistemas de procesos de análisis de Yourdon. Hay convertidores, es lo mismo en esencia, y la documentación debe estar dedicada a su público. Así que durante años escribí por defecto cosas en HTML dentro de código de Visual Basic y después en ASP y PHP. También en C#.

Es como hablar varios idiomas. Si el lector es usuario, es un tipo de documentación; si es público, es otro; contadores, otro; legal, otro.

Igual que Markdown o HTML.