HackerNews

コードウィキはドキュメンテーションシアターとしてのサービス

Code wikis are documentation theater as a service

https://passo.uno/ai-wikis-docs-teather-as-a-service/


Code WikiはGoogleが開発したAIツールで、コードリポジトリから完全なドキュメントセットを自動生成することを謳っています。このツールは、「ドキュメントの作成をやめろ」といった挑発的な表現を用い、真新しいドキュメントが常に得られると主張しますが、実際にはその成果物は多くの問題を抱えており、特に複雑なプロジェクトでは誤情報や不完全な情報が多く見られます。これらのツールは「ウィキ」という言葉を誤用しており、協力編集のプラットフォームとは異なります。ドキュメントは持続的な努力に基づく製品であり、良質なドキュメントは説明やガイドとしての役割を果たします。このようなツールが増えることで、ドキュメンテーションの基準が低下し、開発者が本来必要な人間によるドキュメンテーションの価値を見失う危険性があると言えます。