Section Explaining deleteOldFiles

source/docs/software/advanced-gradlerio/compiler-args.rst

@@ -41,3 +41,17 @@ frcJava(getArtifactClass('FRCJavaArtifact')) {
 }
 ```
 
+## Deleting Unused Deploy Files
+
+By default the `src/main/deploy` directory in your project is transferred to the roboRIO when code is deployed.  It is initiated by this section of the `build.gradle` file.
+
+```c
+frcStaticFileDeploy(getArtifactTypeClass('FileTreeArtifact')) {
+    files = project.fileTree('src/main/deploy')
+    directory = '/home/lvuser/deploy'
+    deleteOldFiles = false // Change to true to delete files on roboRIO that no
+                           // longer exist in deploy directory on roboRIO
+}
+```
+
+This will overwrite any duplicate files found in the `/home/lvuser/deploy` directory on the RIO and copy over any additional not present there.  If `deleteOldFiles` is false it will not remove any files no longer present in the project deploy directory.  Changing it to `true` helps prevent programs like [Choreo](https://sleipnirgroup.github.io/Choreo/) and [PathPlanner](https://github.com/mjansen4857/pathplanner) from getting confused by files that were deleted locally but still exist on the roboRIO. 

source/docs/yearly-overview/yearly-changelog.rst

@@ -165,7 +165,7 @@ Supported Operating Systems and Architectures:
 
 - Use Gradle 8.10.2
 - Use shell scripts for launching tools on Linux / macOS, since macOS doesn't ship Python any more
-- Add method to delete files on roboRIO that have been deleted in the deploy directory. Set deleteOldFiles to true in the frcStaticFileDeploy block
+- Add method to delete files on roboRIO that have been deleted in the deploy directory. :ref:`Set deleteOldFiles to true </docs/software/advanced-gradlerio/compiler-args.html#deleting-unused-deploy-files>` in the frcStaticFileDeploy block
 
 ## WPILib All in One Installer