Complete plugin utility docs

lib/src/main/kotlin/foundation/esoteric/minecraft/plugins/library/utility/plugin/PluginUtility.kt

@@ -11,12 +11,12 @@ import java.nio.file.Path
  *
  * The resource is saved into the plugin's data folder using the same
  * hierarchy as the .jar file (subdirectories are preserved).
- *
  * @param resourcePath the embedded resource path to look for within the plugin's .jar file. (No preceding slash).
  * @param replace if true, the embedded resource will overwrite the contents of an existing file.
  * @throws IllegalArgumentException if the resource path is null, empty, or points to a nonexistent resource.
  * @see Plugin.saveResource
  * @see Plugin.saveResources
+ * @see Plugin.getResource
  * @see Plugin.getDataFolder
  * @see Plugin.getDataPath
  * @author Esoteric Enderman
@@ -31,11 +31,11 @@ fun Plugin.saveResource(resourcePath: Path, replace: Boolean = true) {
  *
  * The resource is saved into the plugin's data folder using the same
  * hierarchy as the .jar file (subdirectories are preserved).
- *
  * @param resourcePath the embedded resource path to look for within the plugin's .jar file. (No preceding slash).
  * @throws IllegalArgumentException if the resource path is null, empty, or points to a nonexistent resource.
  * @see Plugin.saveResource
  * @see Plugin.saveResources
+ * @see Plugin.getResource
  * @see Plugin.getDataFolder
  * @see Plugin.getDataPath
  * @author Esoteric Enderman
@@ -44,6 +44,20 @@ fun Plugin.saveResource(resourcePath: String) {
     saveResource(resourcePath, true)
 }
 
+/**
+ * Saves the raw contents of any resource folder embedded with a plugin's .jar.
+ *
+ * The resources are saved into the plugin's data folder using the same
+ * hierarchy as the .jar file (subdirectories are preserved).
+ * @param resourceFolderPath the embedded resource path to look for within the plugin's .jar file. (No preceding slash).
+ * @return The saved folder `File`.
+ * @throws IllegalArgumentException if the resource path is null, empty, or points to a nonexistent resource folder.
+ * @see Plugin.saveResource
+ * @see Plugin.getResource
+ * @see Plugin.getDataFolder
+ * @see Plugin.getDataPath
+ * @author Esoteric Enderman
+ */
 fun Plugin.saveResources(resourceFolderPath: Path): File {
     val subFolder = File(dataFolder, resourceFolderPath.toString())
     return resourceFolderPath.saveResources(subFolder)