docs: remove internal method reference from API documentation

vitormattos · vitormattos · commit a44991f8ffd8 · 2025-12-30T16:10:43.000-03:00
The API documentation referenced FolderService::getFolderName as
an implementation detail, which should not be exposed to API
consumers. Changed to a generic description of the settings
parameter functionality.

Signed-off-by: Vitor Mattos &lt;1079143+vitormattos@users.noreply.github.com&gt;
diff --git a/lib/Controller/FileController.php b/lib/Controller/FileController.php
@@ -414,7 +414,7 @@ private function fetchPreview(
 	 *
 	 * @param LibresignNewFile $file File to save
 	 * @param string $name The name of file to sign
-	 * @param LibresignFolderSettings $settings Settings to define the pattern to store the file. See more informations at FolderService::getFolderName method.
+	 * @param LibresignFolderSettings $settings Settings to define how and where the file should be stored
 	 * @param list<LibresignNewFile> $files Multiple files to create an envelope (optional, use either file or files)
 	 * @return DataResponse<Http::STATUS_OK, LibresignNextcloudFile, array{}>|DataResponse<Http::STATUS_UNPROCESSABLE_ENTITY, array{message: string}, array{}>
 	 *

Original file line number	Diff line number	Diff line change
`@@ -414,7 +414,7 @@ private function fetchPreview(`
`414`	`414`	`*`
`415`	`415`	`* @param LibresignNewFile $file File to save`
`416`	`416`	`* @param string $name The name of file to sign`
`417`		`- * @param LibresignFolderSettings $settings Settings to define the pattern to store the file. See more informations at FolderService::getFolderName method.`
	`417`	`+ * @param LibresignFolderSettings $settings Settings to define how and where the file should be stored`
`418`	`418`	`* @param list<LibresignNewFile> $files Multiple files to create an envelope (optional, use either file or files)`
`419`	`419`	`* @return DataResponse<Http::STATUS_OK, LibresignNextcloudFile, array{}>\|DataResponse<Http::STATUS_UNPROCESSABLE_ENTITY, array{message: string}, array{}>`
`420`	`420`	`*`