Ayer fue un día de mierda, porque estuve peleándome con problemas técnicos durante buena parte de la noche y al final descubrí que todo eran trampas que habían dejado los autores de herramientas de código abierto.
Los técnicos también tienen personalidades distintas. Siempre hay alguien a quien le gusta escribir la documentación técnica (la dirigida a los usuarios) de forma incomprensible y enrevesada, para destacar lo profundo que es y su estatus. Por ejemplo, ese «proyecto de código abierto de nivel divino» que empieza por x y que usa todo el universo: como su maldita documentación está llena de confusión y ambigüedades 💩, me vi obligado a revisar uno por uno los issues históricos del proyecto en GitHub. Y resulta que al autor no solo le gusta envenenar la documentación para engañar a la gente, sino que también le encanta hacerse el listo una y otra vez en los comentarios de los issues.
Si no te pones a escarbar, no te enteras; pero, al hacerlo, descubrí que el protocolo rxxxxxx y el mecanismo fxxxxxxx, los principales atractivos de este proyecto, reciben páginas y páginas de atención en la documentación, con mayúsculas y todo tipo de bombo, aunque en realidad no pueden coexistir. Y en ningún rincón de la documentación se menciona siquiera 😔. La «ausencia de necesidad de tener un dominio propio», el mayor atractivo del protocolo rxxxxxx, ha resultado ser un pozo sin fondo tras otro durante todos estos años. En los últimos años le han puesto innumerables parches. Hace unos meses, a regañadientes, renuncié a mi dominio; anoche volví al punto de partida, recuperé mi dominio y por fin todo volvió a la calma. Y el protocolo xxxxp, el segundo mayor atractivo del proyecto, ya es…
En realidad, no pasa nada por hacerse el listo. Al fin y al cabo, no hay un primero en literatura ni un segundo en las artes marciales, y además es de código abierto; la gente lo hace por amor al arte, así que tampoco podemos decir mucho. Tampoco pasa nada si hay trampas: los proyectos van mejorando poco a poco. Pero saber que hay problemas y, después de cinco o seis años, seguir sin mencionarlos ni una sola vez en la documentación, obligando a los usuarios a revisar uno por uno todos los issues históricos —o incluso a ir directamente a leer el código fuente— para conseguir que funcione, eso ya es de estar muy mal de la cabeza.
Como ya lo tengo profundamente integrado en mis herramientas personales, no puedo cambiar de inmediato a otra solución, pero voy a buscar varias alternativas más.
A los colegas que sepan de qué estoy hablando: ni se les ocurra decir el nombre completo del proyecto. Quiero seguir vivo 😆.
#小海豹的web3受难日志 📔
Los técnicos también tienen personalidades distintas. Siempre hay alguien a quien le gusta escribir la documentación técnica (la dirigida a los usuarios) de forma incomprensible y enrevesada, para destacar lo profundo que es y su estatus. Por ejemplo, ese «proyecto de código abierto de nivel divino» que empieza por x y que usa todo el universo: como su maldita documentación está llena de confusión y ambigüedades 💩, me vi obligado a revisar uno por uno los issues históricos del proyecto en GitHub. Y resulta que al autor no solo le gusta envenenar la documentación para engañar a la gente, sino que también le encanta hacerse el listo una y otra vez en los comentarios de los issues.
Si no te pones a escarbar, no te enteras; pero, al hacerlo, descubrí que el protocolo rxxxxxx y el mecanismo fxxxxxxx, los principales atractivos de este proyecto, reciben páginas y páginas de atención en la documentación, con mayúsculas y todo tipo de bombo, aunque en realidad no pueden coexistir. Y en ningún rincón de la documentación se menciona siquiera 😔. La «ausencia de necesidad de tener un dominio propio», el mayor atractivo del protocolo rxxxxxx, ha resultado ser un pozo sin fondo tras otro durante todos estos años. En los últimos años le han puesto innumerables parches. Hace unos meses, a regañadientes, renuncié a mi dominio; anoche volví al punto de partida, recuperé mi dominio y por fin todo volvió a la calma. Y el protocolo xxxxp, el segundo mayor atractivo del proyecto, ya es…
En realidad, no pasa nada por hacerse el listo. Al fin y al cabo, no hay un primero en literatura ni un segundo en las artes marciales, y además es de código abierto; la gente lo hace por amor al arte, así que tampoco podemos decir mucho. Tampoco pasa nada si hay trampas: los proyectos van mejorando poco a poco. Pero saber que hay problemas y, después de cinco o seis años, seguir sin mencionarlos ni una sola vez en la documentación, obligando a los usuarios a revisar uno por uno todos los issues históricos —o incluso a ir directamente a leer el código fuente— para conseguir que funcione, eso ya es de estar muy mal de la cabeza.
Como ya lo tengo profundamente integrado en mis herramientas personales, no puedo cambiar de inmediato a otra solución, pero voy a buscar varias alternativas más.
A los colegas que sepan de qué estoy hablando: ni se les ocurra decir el nombre completo del proyecto. Quiero seguir vivo 😆.
#小海豹的web3受难日志 📔

