5d7b68f15e
This PR contains an overhaul of the image component documentation for next (both the [primary usage doc](https://nextjs.org/docs/basic-features/image-optimization) and the [API reference](https://nextjs.org/docs/api-reference/next/image)). This PR does not change the filepath/URL for either of those documents, but that may still be warranted as right now Google searches for "next.js image component" and the like return the API document as the first result, which is not optimal. The changes to the docs are based on feedback from the community and with input from @leerob. I'm marking this PR a draft because we will likely want to have a round of revisions before merging, but in general I consider this PR "read to go," contingent on buy-in from other stakeholders. The basic goal of the changes are as follows: 1. Simplify the getting started page by moving extraneous detail to the API documentation. 2. Refocus the getting started page on practical usage information 3. Add additional content to address issues that have come up as common pain-points around the image component, such as image sizing and styling. Fixes #21786 CC: @styfle @timneutkens @kara @spanicker |
||
|---|---|---|
| .. | ||
| advanced-features | ||
| api-reference | ||
| api-routes | ||
| basic-features | ||
| migrating | ||
| routing | ||
| authentication.md | ||
| deployment.md | ||
| faq.md | ||
| getting-started.md | ||
| going-to-production.md | ||
| manifest.json | ||
| testing.md | ||
| upgrading.md | ||