現存するJSDocタグのまとめ | Memory ice cubes

2024/03/18 6 users まとめ

まとめたいなと思ったが、それは叶わぬ夢なのかもしれない・・・。 JSDoc.app Use JSDoc: Index https://jsdoc.app/#block-tags JSDocの本家（のはず）で、用途は主にドキュメント作成。 以下がその一覧で、AtoZ（エイリアスは別）順。 まずはブロックタグといわれるよく見るもの。 @abstract @virtual @access <package... 続きを読む

zod-to-openapiで、既存のAPI実装にOpenAPIドキュメントを後付けする | Memory ice cubes

2023/11/01 13 users OpenApi API実装 API 既存 ドキュメント

昔々あるところに、既存のWeb APIの実装がありました。 それなりに実装を進めた後に、天の声が言いました。「OpenAPIのドキュメントを公開したい」と。 さて、あなたならどうする？っていうニッチな問いに対する一つの答えとして。 ルーターごと乗り換える？ たとえば今回でいうと、元のAPIはCloudflare Workersにデプロ... 続きを読む

npm workspacesで、TSファイルを共通モジュールとして使い回す | Memory ice cubes

2023/10/10 16 users tsファイル packages package.json

ということをやりたくて、こうやったらできたという覚書。 やりたいこと こういうモノレポ構成とする。 - package.json - package-lock.json - packages - shared - app1 - app2 で、app1にあるコードベースを@myapp/app1とした場合、@myapp/sharedに置いたTSファイルを、そのままモジュールとして利用したいとする。 im... 続きを読む