Revise text with Addressable example

Also update scripts to match by SerializedFile and not AssetBundle because of the hash in name option from Addressables.

Author: SkowronskiAndrew

Documentation/AddressableBuildComparison.png

@@ -4,7 +4,7 @@ The UnityDataTool is a command line tool and showcase of the UnityFileSystemApi
 The main purpose is for analysis of the content of Unity data files, for example AssetBundles and
 Player content.
 
-The [command line tool](./UnityDataTool/README.md) runs directly on Unity data files, without requiring the Editor to be running.  It covers functionality of the Unity tools WebExtract and binary2text, with better performance.  And it adds a lot of additional functionality, for example the ability to create a SQLite database for detailed analysis of build content (See [examples](./Documentation/analyze-examples.md) for more detail).
+The [command line tool](./UnityDataTool/README.md) runs directly on Unity data files, without requiring the Editor to be running.  It covers most functionality of the Unity tools WebExtract and binary2text, with better performance.  And it adds a lot of additional functionality, for example the ability to create a SQLite database for detailed analysis of build content. See [examples](./Documentation/analyze-examples.md) and [comparing builds](./Documentation/comparing-builds.md) for examples of how to use the command line tool.
 
 It is designed to scale for large build outputs and has been used to fine-tune big Unity-based games.
 

Documentation/AddressableSerializedFileComparison.png

@@ -33,6 +33,8 @@ if (-not (Test-Path $db2)) {
 
 # SQL query to compare the content of two builds.
 # Note: when the ID of an object changes then it will not be matched as the same.
+# Note: matching is done based on the SerializedFile, but not the AssetBundle name. In this way AssetBundles that include
+# the content hash in the name can still be compared.
 $query = @"
 ATTACH DATABASE '$db2' AS db2;
 
@@ -86,8 +88,7 @@ FULL OUTER JOIN (
         db2.serialized_files sf ON o.serialized_file = sf.id
     LEFT JOIN
         db2.asset_bundles ab ON sf.asset_bundle = ab.id
-) AS o2 ON o1.asset_bundle = o2.asset_bundle
-    AND o1.object_id = o2.object_id
+) AS o2 ON o1.object_id = o2.object_id
     AND o1.type = o2.type
     AND o1.name = o2.name
     AND o1.serialized_file = o2.serialized_file;
@@ -96,6 +97,5 @@ DETACH DATABASE db2;
 "@
 
 # Execute the query
-Write-Host "Objects with differences, only in one DB, or the same:"
 $results = sqlite3 $db1 ".mode column" $query
 $results | ForEach-Object { Write-Output $_ }

Documentation/RemoveHashName.png

@@ -105,9 +105,8 @@ FULL OUTER JOIN (
         db2.serialized_files sf ON o.serialized_file = sf.id
     LEFT JOIN
         db2.asset_bundles ab ON sf.asset_bundle = ab.id
-) AS o2 ON o1.asset_bundle = o2.asset_bundle
+) AS o2 ON o1.serialized_file = o2.serialized_file
     AND o1.object_id = o2.object_id
-    AND o1.serialized_file = o2.serialized_file
 WHERE NOT (o1.asset_bundle IS NOT NULL AND o2.asset_bundle IS NOT NULL AND o1.crc32 = o2.crc32 AND o1.size = o2.size);
 
 DETACH DATABASE db2;