Update doc for building and downloads

Rework the main page now that builds are being published and to try to improve the instructions for building.

Author: SkowronskiAndrew

README.md

@@ -26,35 +26,44 @@ The repository contains the following items:
 * UnityFileSystemTestData: the Unity project used to generate the test data.
 * TestCommon: a helper library used by the test projects.
 
-## Getting the UnityFileSystemApi library
+## Downloads
 
-The UnityFileSystemApi library is distributed in the Tools folder of the Unity editor (starting in
-version 2022.1.0a14). For convenience this repository includes a copy of the Unity 2022 Windows, Mac and Linux builds of the
-library, in the `UnityFileSystem/` directory. The library is somewhat backward compatible,
-which means that it can read data files generated by any previous version of
-Unity. Ideally, you should copy UnityFileSystemApi (.dll/.dylib) from Unity Editor install path 
-`Data/Tools/` subfolder to `UnityDataTool/UnityFileSystem/` of an Engine version that produced
-serialized data you want to analyze.
+Prebuilt Windows and Mac builds are available in the "Actions" tab. Each update to the main branch triggers a new build.
 
-## How to build
+To use:
+1. Download and unzip the build for your platform.
+2. Run UnityDataTool from the extracted location, or add it to your system PATH.
 
-Currently, we do not host builds of UnityDataTools, you will need to clone or download this repo and build it yourself.
+Refer to the [commit history](https://github.com/Unity-Technologies/UnityDataTools/commits/main/) to see the recent improvements to the tool.
 
-1) The projects in this solution require the [.NET 9.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/9.0).
-2) Copy `UnityFileSystemApi` library from your Unity Editor installation, in 
-`{UnityEditor}/Data/Tools/` to `UnityDataTool/UnityFileSystem/`.  This step is typically optional, because a previously built version of the library is included in the repo that can read the output from most Unity Versions.
-3) Build using `dotnet build -c Release`
+## Getting UnityFileSystemApi
 
-Note: Alternatively you can build with your favorite IDE.  This was tested with Visual Studio and Rider on Windows and Rider on Mac.
+UnityFileSystemApi is distributed in the Tools folder of the Unity Editor (from version 2022.1.0a14). The UnityDataTools repository includes a Windows, Mac, and Linux copy of the library in the `UnityFileSystem/` directory. 
 
-See the documentation page for the [command line tool](./UnityDataTool/README.md) for information about how to run the tool after you have built it.
+The library is backward compatible and can read data files from most Unity versions, so typically the version that is provided with UnityDataTools can be used "as is".
 
-## What is the purpose of the UnityFileSystemApi native library?
+To analyze data using the library from a specific version of the Unity Editor, copy the appropriate UnityFileSystemApi file from your Unity Editor installation (`{UnityEditor}/Data/Tools/`) to `UnityDataTool/UnityFileSystem/` prior to building:
 
-The purpose of the UnityFileSystemApi is to expose the functionalities of the WebExtract and
-binary2text tools, but in a more flexible way. 
+The file name is as follows:
 
-To better understand the files and data formats that the Unity supports in the runtime see [this topic](./Documentation/unity-content-format.md). 
+- Windows: `UnityFileSystemApi.dll`
+- Mac: `UnityFileSystemApi.dylib`
+- Linux: `UnityFileSystemApi.so`
+
+## How to Build
+
+1. Clone or download this repository.
+2. Install the [.NET 9.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/9.0).
+3. (Optional) Overwrite the checked in version of the UnityFileSystemApi library with one from your Unity Editor installation, as described above.
+4. Build using `dotnet build -c Release` or your preferred IDE (tested with Visual Studio and Rider on Windows/Mac).
+
+On Windows, the executable is written to `UnityDataTool\bin\Release\net9.0`. Add this location to your system PATH for convenient access.
+
+See the [command-line tool documentation](./UnityDataTool/README.md) for usage instructions.
+
+## Purpose of UnityFileSystemApi
+
+UnityFileSystemApi exposes the core functionality of WebExtract and binary2text to open and read the Unity Archive and Serialized File formats, exposed as a flexible, performant library. It enables custom tools for binary2text-like output and efficient SQLite database generation.
 
 ## Origins
 
@@ -69,15 +78,8 @@ is extremely slow as it runs WebExtract and binary2text on all the AssetBundles
 has to parse very large text files. It can also easily fail because the syntax used by binary2text
 is not standard and can even be impossible to parse in some occasions.
 
-To address those problems [@faelenor](https://www.github.com/faelenor) established this UnityDataTools
-repository and the UnityFileSystemApi library was created within Unity, to replace the usage of WebExtract and
-binary2text functionalities.  With the library, it becomes very easy to create a binary2text-like tool
-that can output the data in any format, as well as the fast and simpler code for generating the SQLite output.
-
-This tool continues to be useful in recent Unity versions, for example Unity 6.
+UnityDataTools and UnityFileSystemApi were created to overcome these issues, providing fast, reliable access to Unity data files and enabling advanced analysis.
 
 ## Disclaimer
 
-This project is provided on an "as-is" basis and is not officially supported by Unity. It is an
-experimental tool provided as an example of what can be done using the UnityFileSystemApi. You can
-report bugs and submit pull requests, but there is no guarantee that they will be addressed.
+This project is provided on an "as-is" basis and is not officially supported by Unity. It is an experimental tool and example of UnityFileSystemApi usage. Bug reports and pull requests are welcome, but support is not guaranteed.