そのトピックに関する優れた記事は確かにありますが、どれも実際の経験に代わるものではありません.
保守性は、非常に小規模なプロジェクトを除いて、すぐに計画できるものではありません。これは、プロジェクト全体で処理する必要があるものです。実際、大量のクラスとインフラストラクチャ コードを事前に作成すると、単純なスパゲッティ コードよりもさらに理解しにくいコードが生成される可能性があります。
したがって、既存のプロジェクトを継続的にリファクタリングしてクリーンアップすることをお勧めします。変更するのが面倒だった部分を見て、理解しやすく、調整しやすい、より単純なソリューションを目指してください。コードがあまりにも悪い場合は、最初から書き直すことを検討してください。
いくつかの記事を読んだり、新しいフレームワークを使用したからといって、新しいプロジェクトを開始して、それらが成功することを期待しないでください。代わりに、既存のプロジェクトの失敗を特定し、特定の問題を修正してください。コードを変更する必要があるときはいつでも、将来の同様の変更をサポートするためにコードを再構築する方法を自問してください。今後も同様の変更が行われるため、これはとにかく行う必要があることです。
これらのリファクタリングを行うことで、質問したり記事を読んだりできるさまざまな特定の質問に出くわすでしょう。そうすれば、一般的な質問をしたり、メンテナンスやフレームワークに関する一般的な記事を読んだりするだけでなく、より多くのことを学ぶことができます。
今日からコードのクリーンアップを始めてください。将来のプロジェクトに延期しないでください。
(ドキュメンテーションについても同じことが言えます。誰もが最初のドキュメンテーションは非常に悪いものでした。数か月後には、冗長になりすぎて、重要でないものでいっぱいになることが判明しました。そのため、実際に抱えていた問題の解決策でドキュメンテーションを補足してください。次の可能性が高いからです。あなたは同じような問題に直面するでしょう. これらの経験は、「良い書き方」スタイルガイドよりもあなたの文章スタイルを改善します.)