docs: Remove noStore example, encourage NoHttpCache instead

koriym · koriym · commit 18b5578c352a · 2025-11-10T13:49:00.000+09:00
- HttpCache is for configuring cache control, not disabling it
- NoHttpCache is the dedicated attribute for disabling cache
- Keep HttpCache examples focused on actual cache configuration
- Better separation of concerns between attributes
diff --git a/src-annotation/HttpCache.php b/src-annotation/HttpCache.php
@@ -17,10 +17,6 @@
  *
  * Example:
  * ```php
- * // Disable caching (most common use case)
- * #[HttpCache(noStore: true)]
- * // Or use #[NoHttpCache] for simplicity
- *
  * // Cache for 1 hour
  * #[HttpCache(maxAge: 3600)]
  *
@@ -32,6 +28,8 @@
  *
  * // CDN cache for 1 hour, browser cache for 5 minutes
  * #[HttpCache(maxAge: 300, sMaxAge: 3600)]
+ *
+ * // For disabling cache, use #[NoHttpCache] instead
  * ```
  *
  * Interceptors bound:

Original file line number	Diff line number	Diff line change
`@@ -17,10 +17,6 @@`
`17`	`17`	`*`
`18`	`18`	`* Example:`
`19`	`19`	* ```php
`20`		`- * // Disable caching (most common use case)`
`21`		`- * #[HttpCache(noStore: true)]`
`22`		`- * // Or use #[NoHttpCache] for simplicity`
`23`		`- *`
`24`	`20`	`* // Cache for 1 hour`
`25`	`21`	`* #[HttpCache(maxAge: 3600)]`
`26`	`22`	`*`
`@@ -32,6 +28,8 @@`
`32`	`28`	`*`
`33`	`29`	`* // CDN cache for 1 hour, browser cache for 5 minutes`
`34`	`30`	`* #[HttpCache(maxAge: 300, sMaxAge: 3600)]`
	`31`	`+ *`
	`32`	`+ * // For disabling cache, use #[NoHttpCache] instead`
`35`	`33`	* ```
`36`	`34`	`*`
`37`	`35`	`* Interceptors bound:`