paint-brush
Proglogging: el kit de herramientas para detectives del desarrolladorpor@offcode
406 lecturas
406 lecturas

Proglogging: el kit de herramientas para detectives del desarrollador

por Adam Schmideg10m2023/10/09
Read on Terminal Reader

Demasiado Largo; Para Leer

Para Marco, un desarrollador de software con sede en San Francisco, las mañanas normalmente comenzaban con una taza de café humeante y un vistazo a las últimas noticias literarias y tecnológicas.
featured image - Proglogging: el kit de herramientas para detectives del desarrollador
Adam Schmideg HackerNoon profile picture
0-item
1-item

El manuscrito perdido de Sherlock Holmes


En un descubrimiento sorprendente que ha repercutido en el mundo literario, se ha desenterrado un manuscrito previamente desconocido de una historia de Sherlock Holmes. Escondido en un polvoriento ático de una casa de la época victoriana en el histórico distrito de Bloomsbury de Londres, el manuscrito ofrece no sólo una historia no contada del detective más famoso del mundo, sino que también revela una herramienta metodológica utilizada para resolver el caso: un enfoque estructurado que el Dr. John Watson lo denomina "Índice de investigación".

El descubrimiento

El manuscrito salió a la luz durante una venta de propiedades de rutina. El último pariente vivo de los propietarios originales de la casa, un primo lejano de Sir Arthur Conan Doyle, no tenía idea del tesoro que yacía escondido en un baúl de vapor centenario. Sólo cuando un tasador, especializado en libros antiguos, encontró la pila de papeles amarillentos cuidadosamente atados con un cordel, comprendió el significado monumental del hallazgo.

El índice de consultas

Lo que distingue a este manuscrito de otras historias de Holmes es la meticulosa documentación del Dr. Watson de su proceso de investigación utilizando un método que él denomina el "Índice de investigación". Parece que Watson empleó esta forma estructurada de llevar un diario para catalogar observaciones, preguntas y deducciones de manera organizada. El índice no es sólo un recurso narrativo, sino una parte integral de la narrativa, que guía a Holmes y Watson a través de un laberinto de pistas complejas y pistas falsas.


El “Índice de consulta” está diseñado con gran atención al detalle, empleando verbos específicos para iniciar cada entrada, sirviendo como puntos de acción y reflexiones. Las notas de Watson dentro del manuscrito sugieren que veía el “Índice de investigación” como una herramienta universal, adaptable a diversas formas de investigación, no confinada simplemente al trabajo de detective.

Las implicaciones

Tanto los estudiosos como los aficionados están intrigados por esta nueva faceta del canon holmesiano. La Dra. Eleanor Hughes, una destacada experta en literatura victoriana, comentó: “El Índice de Investigación añade una capa completamente nueva a la dinámica Holmes-Watson. No es sólo un método para resolver casos; es una ventana a las mentes disciplinadas que los convirtieron en el dúo de detectives definitivo”.


Además de despertar un renovado interés académico, el “Índice de Investigación” ha llamado la atención de profesionales en diversos campos, desde el periodismo de investigación hasta el desarrollo de software, como un método atemporal para la resolución estructurada de problemas.

¿Que sigue?

Mientras se realizan esfuerzos para autenticar el manuscrito y, si se confirma su autenticidad, publicarlo para que el mundo lo vea, una cosa es segura: el “Índice de investigación” promete ser un tema de discusión y adaptación en los años venideros. Lo que alguna vez fue una herramienta de la era victoriana para resolver los misterios más desconcertantes de Londres pronto puede encontrarse en el centro de los diálogos del siglo XXI sobre el pensamiento analítico y el rigor metodológico.


De hecho, el descubrimiento de este manuscrito perdido de Sherlock Holmes y su “Índice de investigación” no sólo enriquece nuestra comprensión de la historia literaria sino que también ofrece una herramienta atemporal para la investigación, demostrando una vez más que algunos métodos, como los detectives legendarios, son inmortales.


Mientras los académicos y entusiastas de la literatura esperan ansiosamente la publicación del manuscrito recién descubierto de Sherlock Holmes, se nos concede un adelanto exclusivo de la narrativa. Una historia rica en suspenso y desafío cerebral, destaca un método estructurado de investigación denominado "Índice de investigación" por el Dr. John Watson. Este enfoque innovador para desentrañar misterios ofrece una visión fascinante de las mentes disciplinadas detrás del dúo de detectives más famoso de Londres. Sin más preámbulos, les presentamos un extracto de esta fascinante historia perdida sobre Sherlock Holmes y el papel del "Índice de investigación" en la resolución de uno de los casos más desconcertantes del Londres victoriano.

El caso del índice de investigación

Las calles contaminadas de Londres estaban repletas de carruajes tirados por caballos y peatones, cada uno de los cuales seguía con su día, cada uno con una historia que contar. Para el Dr. John Watson, sin embargo, el día comenzó con una peculiar introducción a algo llamado “Índice de Investigación” por parte de un viejo amigo de la guerra. “Es una forma de gestionar el caos, John”, había dicho su amigo, entregándole un diario. Watson, siempre ansioso por encontrar mejores formas de narrar sus aventuras con el enigmático Sherlock Holmes, pensó que podría ser un experimento interesante.


El familiar timbre del apartamento de Baker Street resonó en la habitación, señalando la llegada de un nuevo cliente e, inevitablemente, un nuevo caso. Una señora angustiada relató una serie de robos en todo Londres, robos que aparentemente no tenían relación pero que eran inquietantemente meticulosos.


Mientras Holmes paseaba por la habitación, fumando su pipa, con la mirada perdida en sus pensamientos, Watson aprovechó la oportunidad para comenzar su viaje por el Índice de Investigación.


Empieza: “Los meticulosos robos de Londres”.


Watson anotó los detalles iniciales, la fecha, el nombre del cliente y su historia. Holmes, con su estilo habitual, comenzó a hacer rápidas observaciones, deduciendo hechos sobre la cliente, su situación y la naturaleza de los robos.


Nota: “Todos los robos ocurrieron al anochecer. No hay señales de entrada forzada. Cada objeto robado tenía una historia, una historia”.


Holmes trazó un plan para visitar los lugares de los robos.


Sí: “Visita la mansión de Lord Harrington, el primer lugar del robo”.


Mientras atravesaban los lujosos pasillos de la mansión de Lord Harrington y, más tarde, los callejones poco iluminados del este de Londres, Watson registró meticulosamente sus hallazgos. Cada huella peculiar, cada rumor susurrado en las calles, encontró su camino en el Índice de Investigación de Watson.


Listo: El dúo concluyó sus visitas, habiendo reunido una gran cantidad de información, pero las piezas del rompecabezas no encajaban del todo.


Holmes, en un raro momento, pareció nervioso. Los hilos del caso colgaban fuera del alcance de su brillante mente. Watson, diario en mano, sugirió: “¿Quizás deberíamos revisar nuestros hallazgos?”


Se sentaron junto a la chimenea, con el diario abierto.


Pregunta: “¿Por qué sólo elementos con historia? ¿Cuál es la conexión?


Los dedos de Holmes tamborilearon sobre el reposabrazos mientras Watson reflexionaba en voz alta.


Quizás: “¿Podría el ladrón estar intentando reescribir la historia? ¿O quizás reclamarlo?


La noche avanzaba y el cálido resplandor de la chimenea proyectaba sombras danzantes en las paredes. La hipótesis del “Quizás” los llevó por un sendero de viejas disputas familiares, herencias perdidas y la historia oculta de Londres.


El avance se produjo al amanecer. Una conexión, que antes se había pasado por alto, ahora los observaba desde las páginas del Inquiry Index. Todos los artículos robados se remontan a un único evento en el pasado de Londres: el Gran Incendio.


Con renovado vigor, Holmes y Watson siguieron el liderazgo, lo que culminó en una emocionante persecución por los tejados y los estrechos callejones de Londres. Resultó que el ladrón era descendiente de una familia que lo había perdido todo en el incendio y estaba tratando de recuperar artefactos perdidos para restaurar el honor de su familia.


Lo más destacado: Watson, al reflexionar sobre su aventura, marcó el descubrimiento de la conexión con El Gran Incendio como el punto de inflexión en su caso.


De vuelta en los acogedores confines de Baker Street, una sensación de logro llenó el aire. Holmes, hojeando el índice de investigación, comentó: "Este método suyo, Watson, tiene sus méritos".


Watson sonrió y escribió la última entrada de la noche. El Inquiry Index, inicialmente un experimento, se había convertido ahora en una parte indispensable de sus aventuras. Mientras Londres dormía, los cuentos de Sherlock Holmes y el doctor Watson, estructurados y reflexivos, esperaban su siguiente capítulo.

Sherlock Holmes se encuentra con Proglogging

Para Marco, un desarrollador de software con sede en San Francisco, las mañanas normalmente comenzaban con una taza de café humeante y un vistazo a las últimas noticias literarias y tecnológicas. Un ferviente admirador de Sherlock Holmes, sus ojos se abrieron cuando vio el titular sobre el manuscrito recién descubierto que presentaba un método único llamado "Índice de investigación". Mientras profundizaba en el extracto, se sintió intrigado no sólo por el misterio que se estaba desvelando sino también por el enfoque sistemático del Dr. John Watson para resolverlo.


El “Índice de investigación”, con sus entradas basadas en verbos y su reflexión estructurada, inmediatamente tocó la fibra sensible de Marco. En su mundo de código interminable, sesiones de depuración y plazos ajustados, el caos a menudo resultaba abrumador. ¿Podría un método de la era victoriana ofrecer una solución a los desafíos del desarrollo de software del siglo XXI?


Decidido a descubrirlo, Marco decidió adaptar el “Índice de consultas” a su flujo de trabajo diario. Mientras reflexionaba sobre un nombre más moderno que resonara entre los profesionales conocedores de la tecnología de hoy, le vino a la mente el término "Proglogging", un acrónimo de "programación" y "registro".


Armado con esta nueva herramienta, Marco se embarcó en su siguiente proyecto: implementar una función de modo oscuro para una aplicación móvil. Comenzó presentando sus entradas de Proglogging.

El modo oscuro


Estimación: 4 horas para implementar el cambio de modo oscuro.


Inicio: Función de modo oscuro.


Nota: Las mejores prácticas sugieren usar variables CSS y un interruptor de JavaScript para implementar el modo oscuro.


Qué hacer: definir variables raíz CSS para un tema ligero.


Hecho.


Qué hacer: crear las variables CSS correspondientes en modo oscuro.


Hecho.


Qué hacer: implementar la función de alternancia JS con localStorage para la preferencia de tema.


Hecho.


Pregunta: ¿Cómo realizar una transición fluida entre modos?


Nota: utilice transiciones CSS en las propiedades de color.


Qué hacer: implementar una transición suave entre el modo claro y oscuro.


Hecho.


Agregar: función de prueba en varios navegadores para comprobar la compatibilidad.


Qué hacer: coloque y aplique estilo al botón de alternancia del modo oscuro en la esquina superior derecha.


Hecho.


Descanso: Descanso de estiramiento de 10 minutos.


Qué hacer: probar la palanca en el entorno local.


Nota: La alternancia funciona, pero hay un ligero retraso en el cambio de ícono.


Quizás: Optimice la carga de íconos o use SVG.


Qué hacer: Reemplace los íconos con SVG para resolver el retraso.


Hecho.


Sí: enviar cambios a la puesta en escena para que el equipo los revise.


Hecho.


Destacado: Reemplazar los íconos con SVG para resolver el retraso fue un paso fundamental. Este cambio aseguró una experiencia de usuario fluida y destacó la importancia de la optimización del rendimiento.


Estimación: Ajustada de 4 horas a 3 horas. La implementación de funciones fue más fluida de lo previsto.

Difundiendo la palabra

A medida que avanzaba, Marco descubrió que Proglogging no solo ofrecía una lista estructurada de tareas pendientes, sino también un registro matizado de su proceso de pensamiento, desafíos y logros. Las entradas "Hacer" y "Hecho" proporcionaron un marco claro para la acción, mientras que "Nota" y "Pregunta" permitieron reflexiones y consultas que de otro modo podrían perderse en el acelerado ciclo de desarrollo.


Impresionado por cómo Proglogging mejoró su concentración y productividad, Marco no pudo guardárselo para sí mismo. Durante una reunión de equipo, presentó el método, citando sus intrigantes orígenes en una historia de Sherlock Holmes. Para demostrar su utilidad, los guió a través de su reciente proyecto de modo oscuro, mostrando cómo cada entrada de Proglogging lo ayudó a superar los desafíos técnicos y los ciclos de toma de decisiones.


Inicialmente escépticos, sus colegas no pudieron ignorar el éxito evidente de la función del modo oscuro y el nuevo entusiasmo de Marco. Al final de la semana, Proglogging se había convertido en el método preferido del equipo para la gestión de tareas, y no pasó mucho tiempo antes de que otros departamentos se dieran cuenta.

El método de programación revelado

Al ver el creciente interés en su método Proglogging, Marco decidió tomarse el tiempo para articular sus componentes principales y sus beneficios para su equipo y, eventualmente, para una audiencia más amplia. A continuación se muestra una descripción general del método Proglogging:

Descripción general

Proglogging ofrece un enfoque estructurado para la gestión y reflexión de tareas. Tomando prestado de las prácticas tradicionales de registro y diario, enfatiza el uso de verbos específicos para iniciar cada entrada, asegurando claridad y propósito en la documentación.

Componentes clave

  • Enfoque de entrada única : la programación captura pensamientos de una entrada a la vez, lo que ayuda a la claridad y reduce la sensación de agobio.
  • Instrucciones basadas en verbos : cada entrada comienza con un verbo designado, que establece la intención de la entrada, ya sea una acción, observación o hito.

Verbos centrales

  • Nota : documenta observaciones, ideas o información general.
  • Hacer : Especifica una acción o tarea inminente.
  • Listo : Marca la finalización de la tarea de la entrada "Hacer" anterior.
  • Pregunta : Señala incertidumbres o áreas que necesitan exploración.
  • Quizás : propone posibles soluciones o hipótesis para una preocupación detectada.
  • Agregar : Introduce una tarea o acción futura.
  • Resaltar : Enfatiza logros o desafíos significativos.
  • Estimación : Predice el tiempo o esfuerzo que podría suponer una tarea.
  • Inicio : Señala el comienzo de una tarea o proyecto en particular.
  • Pausa : Marca pausas o intervalos tomados en el flujo de trabajo.

Flexibilidad

Si bien su estructura es fundamental, Proglogging está diseñado para brindar adaptabilidad. Se fomenta la adaptación para alinearse con los flujos de trabajo y las preferencias individuales.

Beneficios

  • Pensamiento estructurado : el enfoque basado en verbos fomenta el pensamiento organizado.
  • Claridad : Las tareas, observaciones y reflexiones están claramente delimitadas.
  • Adaptabilidad : aplicable en diversos escenarios profesionales, desde el desarrollo de software hasta la investigación académica.
  • Reflexión : Fomenta la introspección y el aprendizaje de las experiencias.

Uso y notas

  • Comience con una libreta o herramienta digital. Elabora una entrada que comience con un verbo elegido y sigue su intención.
  • Resaltado : agregue un Resaltado cuando sienta que se ha alcanzado un logro significativo o cuando algo no funcione como se esperaba.
  • Después de sesiones de trabajo prolongadas, revise todas las entradas "Listo". Elija uno o dos como Destacado para resumir la esencia de la sesión.
  • Localice todas las tareas pendientes escaneando las entradas "Agregar".
  • Los verbos centrales son la base. Siéntase libre de ampliarlos o modificarlos según las necesidades individuales. Con el tiempo, los usuarios desarrollan un ritmo y un estilo adaptados a su flujo de trabajo.

El legado continúa

Desde las calles iluminadas con gas del Londres victoriano hasta el brillo LED de las pantallas de computadora contemporáneas, el viaje del 'Índice de investigación' del Dr. Watson al Proglogging de Marco subraya el poder duradero del pensamiento estructurado. El Dr. Watson alguna vez esperó que su método resultara útil para las generaciones futuras y, de hecho, ha encontrado su camino hacia la resolución de problemas modernos. Tanto entonces como ahora, el método sirve como testimonio del ingenio humano y demuestra que las buenas ideas no tienen fecha de caducidad.



Descargo de responsabilidad *: ¡Oh, cómo desearía que esta historia fuera cierta! Pero, por desgracia, la historia que lees sobre un "manuscrito de Sherlock Holmes recién descubierto" es pura ficción, surgida de lo más profundo de mi imaginación. Hasta donde todo el mundo sabe, Sir Arthur Conan Doyle no nos ha enviado ninguna sorpresa póstuma.*


[Siguiente historia de la serie: Cuando la IA se une al equipo de desarrollo ]