When analyze finishes it prints the processed-file counts and the total time, but nothing about what to do next:
Finalizing database. Successfully processed files: 2, Failed files: 0, Files without TypeTrees: 0, Ignored files: 0
Total time: 0.256 s
In a usability experiment, an AI agent given only the binary discovered the built-in views (object_view, view_breakdown_by_type, ...) by running .tables in sqlite3 and called it "a lucky/pleasant discovery, not something --help mentioned". For someone using the downloaded binary, stdout plus the one URL in --help is the entire discovery surface.
Proposal: after finalizing, print a short next-step hint, something like:
Database written to database.db. Start with the object_view and view_breakdown_by_type views.
Schema reference: https://github.com/Unity-Technologies/UnityDataTools/blob/main/Documentation/analyzer.md
The URL should be version-pinned once the --help documentation link is (tracked separately).
When
analyzefinishes it prints the processed-file counts and the total time, but nothing about what to do next:In a usability experiment, an AI agent given only the binary discovered the built-in views (
object_view,view_breakdown_by_type, ...) by running.tablesin sqlite3 and called it "a lucky/pleasant discovery, not something --help mentioned". For someone using the downloaded binary, stdout plus the one URL in--helpis the entire discovery surface.Proposal: after finalizing, print a short next-step hint, something like:
The URL should be version-pinned once the
--helpdocumentation link is (tracked separately).