AIに食わせる前提のDocs as Codeは合理的。でもドキュメントとコードの乖離をAIが検知する仕組みまでセットじゃないと結局詰みそう
ドキュメント簡単に作れちゃうけど、そのうち仕様・実装とドキュメントの同期が大変になってきて、さらにはどのドキュメントが現実と乖離してるのかもわからなくなるという未来が見えます。
? Code as docs? 酔ってるので後でよく読む
文芸的プログラミング
変更した時に影響箇所をすべてのドキュメントに対して再編集できればいいけど。その仕組みがまだ出来てない。
API定義はOpenAPI yaml を使った方が良いと思います.. viewer有るから読めるし
チームで本格的に Docs as Code を運用しているので紹介します - エムスリーテックブログ
AIに食わせる前提のDocs as Codeは合理的。でもドキュメントとコードの乖離をAIが検知する仕組みまでセットじゃないと結局詰みそう
ドキュメント簡単に作れちゃうけど、そのうち仕様・実装とドキュメントの同期が大変になってきて、さらにはどのドキュメントが現実と乖離してるのかもわからなくなるという未来が見えます。
? Code as docs? 酔ってるので後でよく読む
文芸的プログラミング
変更した時に影響箇所をすべてのドキュメントに対して再編集できればいいけど。その仕組みがまだ出来てない。
API定義はOpenAPI yaml を使った方が良いと思います.. viewer有るから読めるし