ソースやSCMはそれを処理してみましょう：歴史ファイル？

StackOverflow https://stackoverflow.com/questions/929824

  •  06-09-2019
  •  | 
  •  

質問

私は自分のソロのSCMソフトウェアとして水銀を学んでいます。他の管理ソフトウェアを使用すると、タグによるファイルのヘッダーに変更コメントを置くことができます。 HGを使用すると、変更セットをコメントし、それが元に取得していません。私はVSSのような中央制御をより慣れています。

なぜ私はソースファイルのヘッダにファイル履歴を置く必要がありますか？私は水銀私のチェンジセットコメント履歴を管理しましょうべきでしょうか？

役に立ちましたか？

解決

ソース管理システムがそれを処理してみましょう。

あなたは、ヘッダーに変更内容を入れた場合は、

それはすぐに手に負えなくなり、実際のコードを圧倒します。

SCMは（多くのファイルが単一の変更にグループ化されている）チェンジの概念を持っている場合、それは全体の変化に適用され、1つのファイルにだけではなく、編集ように、

また、あなたは、コメントを書くことができるようになりますあなたの編集が必要とされた理由の鮮明な画像を与え、（それが理にかなっている場合）。

他のヒント

はい。ソース管理システムは、あなたのチェンジのコメントを処理させます。変更のコメントを提示することができ、ソース管理システムを試してみて、状況を啓発するために - これの根拠は、それはあなたがファイルの2つのバージョン間で何が起こっているのかうまくしようとすると、後から変更ログを表示しているかなり多くの理にかなっているということですます。

SCMソフトウェアは、この問題を解決するために非常に適していたときに、手動でファイルの履歴を維持する理由はありません。すべてあまりにも頻繁に、人々は間違ってそれが正確であると仮定ので、私は、実際に痛い源に部分的に完成したファイルの履歴を参照してください。

の違いは、それは、それが変更されているものについての詳細集中型または分散型VCSだのかどうかではありません。

私は.NETに移動すると、

、任意の個々の変更のために更新されたファイルの数が急騰するように見えました。私は、各ファイルの変更をログに記録しなければならなかった場合は、私が行って任意の本当の仕事を得ることはありませんでした。一連の変更についてコメントすることで、私が更新しなければならなかったどのように多くのファイルは問題ではありません。

私が今までに特定の変更のためにすべての変更を識別するために必要な場合、私はプロジェクトの2つのバージョン間のdiffをすることができます。

離れSourceSafeから切り替えたときに、私が見た最大の違い（および利点は）ベースのコミットを投影するベースのファイルからスイッチしました。できるだけ早く私はそれに慣れて、私は私のすべてのファイルに変更ログタイプのコメントを追加することを停止ます。

（副作用として、私は私のプロセス記述のコメントがよくなっていることがわかってきました）。

私は、変更のコメントでコードをポイ捨ての大きな支持者ではありませんよ。イベントでは、彼らは、彼らは（少なくとも私が使用しているSCMバリアント用）SCMで検索することができます必要があります。あなたはファイルでそれらをしたいです場合は、代わりに最初の最後にそれらを置くことを検討してください。その方法は、あなたが実際のコードに到達する前に（少なくとも私には、面白くない）を過ぎて、コメントを下にスクロールする必要はありません。

SCMシステムをさせるためのもう一つの投票は、チェックインのコメントを扱うが、私は追加する一つのことを持っています。

一部のシステムでは、SCMは、直接自動的にコミットされているソースファイルに変更履歴を挿入することができ、あなたのソースコードにRCSタグを使用することができます。歴史はSCMシステムで、その後で、その後、自動的にソースコード自体に入れているので素敵なバランスのような音ます。

問題は、このプロセスは、の変更のソースファイルということです。私は、ファイルがあなたのコメントが挿入された後まで、ディスク上で変更することはできませんので、それは悪いアイデアだと思います。あなたは良いエンジニアだったら、あなたは構築され、コミットする前に変更をテストしている必要があります。後のソースの変更がコミットする場合は、基本的に破られる可能性がビルドを持っている - しかし、ほとんどのエンジニアは、コミット後にビルドできないだろう - ？なぜべき彼ら

しかし、それはあなたが言うだけのコメントです！確かに、私は不思議なRCSヘッダータグやコードのセクションは、それによって私のコードをいじる、チェックインに置き換えられてしまったように、のを見に理由があった私のソースファイル内のコードがあった場合を持っていました。ビルドが20+のユーザーのために壊れてしまったことを簡単に修正するのに十分な、悪い

はるかに簡単（IMO）は常に1として、ソースに歴史を維持するために忘れて制御システムの問題dissappersを調達するためにコミットコメントすべきです。コミットの前にたくさんのファイルを変更する場合にも、すべてのファイルで歴史を変えることは煩わしい作業になります。これは本当に、SCMを有する点の一つである。

私はこの経験を持っています。私はそれがののひどかった、コメント内のファイルの履歴を持っていました。ゴミは何も、時にはあなたは、あなたが最終的にあなたが望んでいたものになった前に、コードの変更のほとんど1Kラインを下にスクロールする必要はないだろう。ではないに言及し、を、あなたのソースコードツリーへのより多くのキロバイトを追加することにより、ビルドプロセスの他の側面を遅くしている。の

ライセンス： CC-BY-SA と 帰属
所属していません StackOverflow
scroll top