/ddddddiary

ルノアールでごちゃごちゃやる。

---

• RSS を使った情報収集をちゃんとやりたい気持ちになった。ので、 miniflux を Hetzner にセルフホストしてみる。miniflux 自体は素朴な UI しかないので、ローカルにインストールした RSS リーダーでこいつを読みに行けばよさそう。
  • とりあえず JSer.info の opml ファイルをぶち込んでみる。macOS の RSS リーダー自体は何がいいんかわからんな。lire とかがいいんかな。
• 流れで wallabag も入れてみる（コイツは docker で動かすのがなかなか面倒だった）。wallabag いい。ワンクリックでそのウェブページを Readability 化して登録してくれるのが体験⭕️。今までは slack になんとなく後で読む系の URL は貯めてたんだけど、こっからはここに貯めてけばよさそうな気がする。で、暇なときにまとめて読む、みたいなことができそう。
  • miniflux は wallabag に記事を横流しできる機能もあるっぽい。
  • Omnivore とか Pocket とか同じような立ち位置のマネージドサービスはあったんだけどみんなサ終したという経緯もあり、この辺を SaaS に依存するのはなかなか厳しい雰囲気がある。
    • Obsidian Web Clipper もいいかもしれない。 というか、こっちのほうがいいか？
  • RSS は Feedly とか Inoreader とか強いサービスがあるが、しかし Google Reader が終わるなんて誰も考えていなかったわけで、、、

ねぎしで牛タンを食う。ルノアールに籠もる。

---

• ｺｯｶﾗSaaS
  • かなりおもろい（転職を経てこの辺の話がちょっと面白く感じらられるようになった）。クラスメソッドの記事まである。クラメソめちゃくちゃ成長してるんだなぁ…

出社。弁当。帰宅。ビーフン。自分の一日が14文字に圧縮可能という事実に慄然とする。時間と精神を売り渡して生きてる。

---

• Carbon | Create and share beautiful images of your source code
  • X でよく見るコードのスクショ、これで作ってたのか（そしてドメインが now.sh だ）
• Links, Resources, and Humans of Note - Infrequently Noted
  • Alex Russell（PWA の発案者の一人）の Web パフォーマンスに関するリンク集。JavaScript は少なければ少ないほど良いよね、みたいなこと言ってて、そうなんだけど、仕事で SPA を作ってるワシは沈黙した。
    • このステッカーは欲しい。そういえば Anti Social Social Club って見なくなったよね。

出社。帰宅。そしてビーフン。頑張って仕事した。成果がそれなりに出て安心する。

---

• 実装を詳細に説明した完全な仕様書を作るのは、メンテナンスのことを考えると誤った選択だ。実際は、基本的な概要と API 定義（自動生成したもの）、あとは基本的なシナリオのフローチャートとかシステム間の相互作用図ぐらいが書いてあればいいのではないか。それらはプレーンテキストでコードと併置されていることが望ましい（理由は言うまでもない）。もちろんビジネス的な事情がある場合、ある機能に関しては Wiki 的なものに実装のスナップショットを書かなきゃいけないこともあるだろうが、それは可能な限り最小限に留めておきたい。
• 「完全な仕様書」と比較すると、例えば ADR のような、なぜこう実装したのかという意思決定の背景を残すのは良い選択だ。仕様書はメンテナンスの必要があるが、「ある瞬間の意思決定の背景」についてはメンテナンスの必要がないからだ。それでいて、必要なときに参照することで実質的な仕様書として機能することができる。よほど体力のあるチームでない限り、メンテナンスするべき対象は少ないほど望ましい。コードや仕様書は書かれた瞬間から腐っていくし、ひとはいつか必ず退職する。そう、あなた自身も…
• いや、AI に「完全な仕様書」を書かせて PR のマージ前とかにジョブで修正させればもうええか。ワシが間違ってた、死のう（おわり）
• Docs as Code って言葉を知った。これをやりたいがなぁ

在宅。疲労が残る。かなりサボっちまった。ビーフンを作り、食う。ビーフンがうまい。