昨日は本当にクソみたいな一日だった。技術的な問題に夜中まで振り回されて、最後に分かったのは、全部オープンソースツールの作者が仕掛けた地雷だったということ。
技術者にもいろんな性格の人がいて、利用者向けの技術ドキュメントをわざと分かりにくく、難解に書いて、自分の知識や地位の高さを誇示したがる人がいる。たとえば、全宇宙で使われている、某「x」から始まる“神レベル”のオープンソースプロジェクト。クソみたいなドキュメントが混乱と曖昧さだらけ💩なので、仕方なくGitHubでプロジェクトの過去のissueを一つずつ掘り返したら、作者はドキュメントに毒を仕込んで人をミスリードするだけでなく、issueのコメント欄でも何度もドヤ顔でマウントを取っていた。
掘り返してみないと分からないものだ。調べて初めて、このプロジェクトが売りにしているrxxxxxxプロトコルとfxxxxxxxの仕組みは、ドキュメントで何度も大々的に強調されているのに、実は両立できないと分かった。なのに、ドキュメントの隅っこにはそのことが一切書かれていない😔。rxxxxxxプロトコルの最大の売りである「独自ドメイン不要」も、ここ数年は地雷に次ぐ地雷で、何度もパッチが当てられてきた。数か月前、しぶしぶドメインを手放したのに、昨夜また振り出しに戻ってドメインを取り戻したら、ようやく平和になった。プロジェクトの第二の売りであるxxxxpプロトコルに至っては、もう……。
見栄を張るのは別にいい。文に一番も二番もないし、武にも一番も二番もない。それにオープンソースだし、愛で開発してくれている人にあれこれ言うわけにもいかない。地雷があるのも仕方ない。プロジェクトは少しずつ改善されていくものだから。でも、地雷があると分かっていながら、5、6年たってもドキュメントには一言も書かず、利用者に過去のissueを一つずつ掘り返させたり、果てはソースコードを直接読み解かないと動かせないようにしたりするのは、さすがにどうかしてる。
もう私の個人用ツールに深く組み込まれてしまっているので、すぐに別の代替手段に切り替えることはできないけど、候補をいくつか追加で用意しておくことにする。
何のことか分かった仲間たち、プロジェクト名をそのまま書くのだけは絶対やめてくれ。生きていたいんだ😆。
#小海豹的web3受难日志 📔
技術者にもいろんな性格の人がいて、利用者向けの技術ドキュメントをわざと分かりにくく、難解に書いて、自分の知識や地位の高さを誇示したがる人がいる。たとえば、全宇宙で使われている、某「x」から始まる“神レベル”のオープンソースプロジェクト。クソみたいなドキュメントが混乱と曖昧さだらけ💩なので、仕方なくGitHubでプロジェクトの過去のissueを一つずつ掘り返したら、作者はドキュメントに毒を仕込んで人をミスリードするだけでなく、issueのコメント欄でも何度もドヤ顔でマウントを取っていた。
掘り返してみないと分からないものだ。調べて初めて、このプロジェクトが売りにしているrxxxxxxプロトコルとfxxxxxxxの仕組みは、ドキュメントで何度も大々的に強調されているのに、実は両立できないと分かった。なのに、ドキュメントの隅っこにはそのことが一切書かれていない😔。rxxxxxxプロトコルの最大の売りである「独自ドメイン不要」も、ここ数年は地雷に次ぐ地雷で、何度もパッチが当てられてきた。数か月前、しぶしぶドメインを手放したのに、昨夜また振り出しに戻ってドメインを取り戻したら、ようやく平和になった。プロジェクトの第二の売りであるxxxxpプロトコルに至っては、もう……。
見栄を張るのは別にいい。文に一番も二番もないし、武にも一番も二番もない。それにオープンソースだし、愛で開発してくれている人にあれこれ言うわけにもいかない。地雷があるのも仕方ない。プロジェクトは少しずつ改善されていくものだから。でも、地雷があると分かっていながら、5、6年たってもドキュメントには一言も書かず、利用者に過去のissueを一つずつ掘り返させたり、果てはソースコードを直接読み解かないと動かせないようにしたりするのは、さすがにどうかしてる。
もう私の個人用ツールに深く組み込まれてしまっているので、すぐに別の代替手段に切り替えることはできないけど、候補をいくつか追加で用意しておくことにする。
何のことか分かった仲間たち、プロジェクト名をそのまま書くのだけは絶対やめてくれ。生きていたいんだ😆。
#小海豹的web3受难日志 📔

