Merge pull request #33889 from nextcloud/debt/noid/docblock-cache-for

Update docblock for cacheFor

Author: kesselb

lib/public/AppFramework/Http/Response.php

@@ -105,8 +105,10 @@ public function __construct() {
 
 	/**
 	 * Caches the response
-	 * @param int $cacheSeconds the amount of seconds that should be cached
-	 * if 0 then caching will be disabled
+	 *
+	 * @param int $cacheSeconds amount of seconds the response is fresh, 0 to disable cache.
+	 * @param bool $public whether the page should be cached by public proxy. Usually should be false, unless this is a static resources.
+	 * @param bool $immutable whether browser should treat the resource as immutable and not ask the server for each page load if the resource changed.
 	 * @return $this
 	 * @since 6.0.0 - return value was added in 7.0.0
 	 */