docs: update description for `static` folder (#15087)
authorScott Wu <sw@scottwu.ca>
Wed, 24 Dec 2025 13:44:16 +0000 (21:44 +0800)
committerGitHub <noreply@github.com>
Wed, 24 Dec 2025 13:44:16 +0000 (05:44 -0800)
Co-authored-by: Ben McCann <322311+benmccann@users.noreply.github.com>
documentation/docs/10-getting-started/30-project-structure.md

index a3ea68fe8618f14182eb0d1e8030ba4719c029f0..d1db3547ca34de45aeed84bf09f475aa4b21054c 100644 (file)
@@ -65,7 +65,7 @@ If you added [Vitest](https://vitest.dev) when you set up your project, your uni
 
 ### static
 
-Any static assets that should be served as-is, like `robots.txt` or `favicon.png`, go in here.
+Any static assets that should be served without any alteration to the name — such as `robots.txt` — go in here. It's generally preferable to minimize the number of assets in `static/` and instead `import` them. Using an `import` allows [Vite's built-in handling](images#Vite's-built-in-handling) to give a unique name to an asset based on a hash of its contents so that it can be cached.
 
 ### tests