Add known issue for Mac simulation crash after upgrade (#1745)

Co-authored-by: sciencewhiz <[email protected]>

Author: PeterJohnson

source/docs/yearly-overview/known-issues.rst

@@ -34,6 +34,13 @@ Updating Properties on roboRIO 2.0 may be slow or hang
 
 **Workaround:** After a few minutes of the tool waiting the roboRIO should be able to be rebooted and the new properties should be set.
 
+Simulation crashes on Mac after updating WPILib
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+**Issue:** On macOS, after updating the project to use a newer version of WPILib, running simulation immediately crashes without the GUI appearing.
+
+**Workaround:** In VS Code, run WPILib | Run a command in Gradle, ``clean``. Alternatively, run ``.\gradlew clean`` in the terminal or delete the build directory.
+
 Invalid build due to missing GradleRIO
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^