オープンソースプロジェクトは、その設計やアーキテクチャに関するドキュメントなしで成功するにはどうすればよいですか？

有名なオープンソースプロジェクトを勉強してプログラミングスキルを向上させたいのですが、ソースコードに飛び込むだけで簡単に迷子になります。

そこで、最初にコードの構成に関する一般的なアイデアを得るために、設計またはアーキテクチャ（UMLダイアグラムなど）に関するドキュメントを読むことにしました。しかし、驚いたことに、Hibernate、Spring、ASP.NET MVC、Railsなどの大規模なオープンソースプロジェクトのアーキテクチャドキュメントは見つかりませんでした。

だから私は疑問に思い始めました：新しい開発者が読むべきアーキテクチャ/設計ドキュメントがない場合、またはプロジェクトマネージャーがソースコードを開いただけでドキュメントを閉じた場合、オープンソースプロジェクトはどのように成功するのでしょうか？

なぜ新人の開発者が読むべき建築/設計ドキュメントを持っていないのに、オープンソースプロジェクトが成功できるのか？

前提は常に、自分が何をしているのかを知っており、あなたが見ようとしている（そして期待している）ことについて合理的に密接に理解しているということです。

たとえば、SymfonyフレームワークのPHPコードを調べると、依存性注入、イベント、モデル/ビュー/コントローラーパターンなどについて既に知っていることが期待されます。

同様に、LinuxカーネルのCコードに飛び込む場合、モジュール性、シグナル、プロセス、スレッドなどの現実的な能力を備えていることが前提となります。また、1日16進数で16進数を食べ、巨大なシャベルでコアダンプを掘り下げるコツが必要です。

メンテナは、それが事実問題であるため、アーキテクチャを文書化する手間をかけません。場合によっては、ソースツリーのどこに何があるのか​​を知ることができます。しかし、より一般的には、ソースツリーの編成方法により、説明がわかりやすくなります。

要するに、コードを覗くまでにメンテナーがあなたに知っていると期待するスキルのいずれかが欠けているなら、おそらくあなたの給料等級をはるかに超えるものを掘り下げているでしょう。最初に概念を理解してください-MVCモデルとは何ですか？依存性注入とは何ですか？その後、ダイビングします。

最も成功したオープンソースプロジェクトが成功したのは、何よりもまず、プログラムが印象的であったか、当時他のプログラムではできなかったことをしたからです。プロジェクトを始めたプログラマーはコードを必要としないほど十分に知っているので、それは必ずしもソースが十分に文書化されていることを意味しません。不幸なことに、オープンソースプロジェクトを十分に文書化する必要はありません。それは良いプログラムであるか、平凡なプログラムである必要がありますが、プログラマーがそれに興味を示すには十分に文書化されている必要があります。

通常、オープンソース開発者は才能があり、専門分野でもプロジェクトを選択しているため、頭蓋骨にはすでに「ドキュメント」があります。誇張はほとんどありませんが、これらのいずれかが欠けている場合にのみ徹底的なドキュメントが必要です：o）

正直なところ、未知のコードベースに直面しているとき、私は実際に「ドキュメント」を読みません。簡単な紹介、いくつかの概念的なスケッチ、そしてコードにまっすぐ入ってください！実験して、小さな変更を試してください。適切に設計されたコードに最適です。私が恐ろしい混乱に直面した場合、それらを学ぶ最善の方法は、明確に改善するために少しずつリファクタリングすることです（理想的には単体テストの助けを借りて）。

追加の理由は、これらのプロジェクトの単純なオーガニックデザインのルーツかもしれません。そのため、アーキテクチャーは、「文書化された」エンティティーというよりも、開発者の頭の中で進化したビジョンです。

そのようなドキュメントがしばしば存在しない理由は非常に単純です：プログラマはドキュメントを書くのではなく、プログラミングするのが好きです。特に、オープンソースプロジェクトでは、開発者が空き時間や余暇によく貢献します。

基本的に、ドキュメントを書くのは面白くない。そして、もし彼らがそれに対して支払いを受けないなら、誰も彼らの自由な時間を楽しくない何かをして過ごしたいと思うでしょうか？