chore: update phpdocs and openapi spec

Signed-off-by: Elizabeth Danzberger <lizzy7128@tutanota.de>

Author: elzody

apps/files/lib/Controller/TemplateController.php

@@ -52,6 +52,14 @@ public function list(): DataResponse {
 		}, $this->templateManager->listTemplates()));
 	}
 
+	/**
+	 * List the fields for the template specified by the given file ID
+	 *
+	 * @param int $fileId File ID of the template
+	 * @return DataResponse<Http::STATUS_OK, array<string, FilesTemplateField>, array{}>
+	 *
+	 * 200: Fields returned
+	 */
 	public function listTemplateFields(int $fileId): DataResponse {
 		$fields = $this->templateManager->listTemplateFields($fileId);
 

lib/private/Files/Template/TemplateManager.php

@@ -19,6 +19,7 @@
 use OCP\Files\Node;
 use OCP\Files\NotFoundException;
 use OCP\Files\Template\BeforeGetTemplatesEvent;
+use OCP\Files\Template\Field;
 use OCP\Files\Template\FileCreatedFromTemplateEvent;
 use OCP\Files\Template\ICustomTemplateProvider;
 use OCP\Files\Template\ITemplateManager;
@@ -253,6 +254,9 @@ private function getUserTemplates(TemplateFileCreator $type): array {
 		return $templates;
 	}
 
+	/*
+	 * @return list<Field>
+	 */
 	private function getTemplateFields(TemplateFileCreator $type, int $fileId): array {
 		$providerTemplates = $this->getProviderTemplates($type);
 		$userTemplates = $this->getUserTemplates($type);