docs: Put noStore example first as most common use case

koriym · koriym · commit 8015dd251ad7 · 2025-11-10T13:47:58.000+09:00
- Start with noStore (most frequently used for API responses)
- Emphasize explicit intent to disable caching
- Mention NoHttpCache as simpler alternative
- Reflect actual usage frequency in example order
diff --git a/src-annotation/HttpCache.php b/src-annotation/HttpCache.php
@@ -17,6 +17,10 @@
  *
  * Example:
  * ```php
+ * // Disable caching (most common use case)
+ * #[HttpCache(noStore: true)]
+ * // Or use #[NoHttpCache] for simplicity
+ *
  * // Cache for 1 hour
  * #[HttpCache(maxAge: 3600)]
  *
@@ -28,8 +32,6 @@
  *
  * // CDN cache for 1 hour, browser cache for 5 minutes
  * #[HttpCache(maxAge: 300, sMaxAge: 3600)]
- *
- * // For no caching, use #[NoHttpCache] instead
  * ```
  *
  * Interceptors bound:

Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,10 @@`
`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`	`+ *`
`20`	`24`	`* // Cache for 1 hour`
`21`	`25`	`* #[HttpCache(maxAge: 3600)]`
`22`	`26`	`*`
`@@ -28,8 +32,6 @@`
`28`	`32`	`*`
`29`	`33`	`* // CDN cache for 1 hour, browser cache for 5 minutes`
`30`	`34`	`* #[HttpCache(maxAge: 300, sMaxAge: 3600)]`
`31`		`- *`
`32`		`- * // For no caching, use #[NoHttpCache] instead`
`33`	`35`	* ```
`34`	`36`	`*`
`35`	`37`	`* Interceptors bound:`