The setup wizard in Bolt 1 has minor design issues. Some pages of the wizard are intimidating to non-technical users and it is unclear that they are optional. Bolt 2 should address both of these problems with the following changes:
- Reworking the Documentation Generation to:
- Show explicit warnings when MSBuild is not found, the main (but easily fixable) cause of generation failure
- Use the Unity Assembly Definition API for project file detection instead of manual directory traversal, which can lead to trying to generate outdated projects
- Moving the Generate Inspectors step out of the Setup Wizard (but keeping it available as a standalone menu dialog). It is likely to fail and restart the wizard because of a Unity bug and it is only required in rare cases.
- Renaming “Generate Inspectors” to “Generate Serialized Property Proxies” to clearly indicate that it is not a requirement for Bolt inspectors to work. It is, in fact, a way of displaying custom property drawers from Unity via their SerializedProperty system. A manual page should be added to explain the use and requirement of this operation.
- Merging the Assemblies and Types page in a unified Extractor page, with more options, clearer explanations and faster generation (see Extractor for more details)
- Improving the Setup Complete page with cleaner, more informative buttons