公開しているライブラリほどじゃないにせよ、チームで開発しているTypeScriptで書いたコードにちらほらドキュメンテーションしていきたい。 それESLintで とりあえず今までろくに書いていなかった部分はいまさっき書き足すPull Requestを作ったけれど、今後手を入れる時にもちゃんと書いていってほしい。 で、こういうルールの徹底を人間がレビューで「ドキュメントおねがいします」って言うのは不毛。2020年代にやっていいことではない。 TypeScript/JavaScriptでやろうとなったらESLintでどうにかしたい。eslint-plugin-jsdocがJSDocに関連したルールを提供している。 JSDocはTSDocと基本的なフォーマットは同じで細かいタグのセマンティクスは差異がありそう。 そしてなんとeslint-plugin-jsdocはTypeScriptもサポートし

HTTP APIのキャッシュ戦略を考えながら、ふとcache-controlなどを指定しなかったとき、デフォルトのキャッシュ戦略はどのように定義されているのか気になったので調べた。 Storing Responses in Caches RFC7234のStoring Responses in Cachesにレスポンスをキャッシュしてもよい条件が述べられている。 A cache MUST NOT store a response to any request, unless: The request method is understood by the cache and defined as being cacheable, and the response status code is understood by the cache, and the "no-store" cache

この記事は、はてなデベロッパーアドベントカレンダーの19日目の記事です。 昨日は、id:t_kyt による あれから一年、あの TypeScript プロジェクトは今 - 多幸感 でした。 すばやく、かつ堅牢にアプリケーションをつくる ボタンを連打したくなる性と向き合う サーバサイドにおける工夫 イベントソーシング リクエストに複数のリソースを含められるように クライアントサイドにおける工夫 イベントのバッファリング accumulate-call で簡潔に書く むすび すばやく、かつ堅牢にアプリケーションをつくる はてなの id:aereal です。アプリケーションエンジニアとして日々、サービスの開発に携わっています。 はてなではサービス開発合宿が年に一度ほどのペースで開催されています *1。今年もつい先日開催されました。 私たちのチームは技術的な挑戦を行う一方で、プロトタイプではなく初