更新後と見比べるために、更新前の状態をファイルに残します。作業の記録の書式と置き場所は、プロジェクトの決まりに従います（ここで作るファイルは、見比べるための作業用のものです）。出力ファイルはプロジェクトのフォルダー（pom.xml または build.gradle のある場所）にできます。これらの出力ファイルはコミットしません。

依存関係を記録する

Maven

mvn dependency:tree "-Dverbose" 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8 dependency-tree-before-all.txt
mvn dependency:tree "-Dverbose" "-Dincludes=<groupId>:*" 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8 dependency-tree-before-target.txt
mvn help:effective-pom 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8 effective-pom-before.txt

Gradle

./gradlew -q --console=plain dependencies --configuration runtimeClasspath 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8 dependency-tree-before-all.txt
./gradlew -q dependencyInsight --dependency "<groupId>:<artifactId>" --configuration runtimeClasspath 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8 dependency-insight-before.txt

<groupId>・<artifactId> は、バージョンページの見出しの座標に置き換えます。

依存定義のどこでバージョンが決まっているかを記録する

1. pom.xml（または build.gradle・build.gradle.kts・gradle/libs.versions.toml）で、対象の座標を検索する
2. バージョンがどこで決まっているかを記録する：直接の記述／プロパティ／dependencyManagement／親 POM／BOM／Gradle の constraints・platform・バージョンカタログ
3. 関連するモジュール（同じ groupId の別の成果物）も記録する
4. scope（Gradle では configuration）・optional・exclusions を記録する
5. WEB-INF\lib などに手で置いた JAR が無いかも確かめる

設定値を記録する

対象のライブラリに関係する設定を記録します（web.xml・properties・XML の設定ファイル・Java の設定クラスなど）。バージョンページの「設定を見直す」で挙げられた項目は必ず記録します。