Conversation
✅ Deploy Preview for astro-docs-2 ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
This comment was marked as outdated.
This comment was marked as outdated.
|
I created withastro/astro#11961 to fix the error messages broken links |
Co-authored-by: delucis <delucis@users.noreply.github.com>
* Add loader reference to the beta docs * Move integration info to integrations ref page * Apply suggestions from code review Co-authored-by: Luiz Ferraz <luiz@lferraz.com> Co-authored-by: Armand Philippot <git@armand.philippot.eu> * Apply suggestions from code review Co-authored-by: Armand Philippot <git@armand.philippot.eu> * Changes from review * Changes from review * Extract DataEntry type * Apply suggestions from code review Co-authored-by: Armand Philippot <git@armand.philippot.eu> * Sarah tiny nits * sarah tiny edit * Apply suggestions from code review Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca> * Add usage example * Update src/content/docs/en/reference/loader-reference.mdx --------- Co-authored-by: Luiz Ferraz <luiz@lferraz.com> Co-authored-by: Armand Philippot <git@armand.philippot.eu> Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
| - **Frequently changing content**: Generate individual pages without requiring a static rebuild of your site. This is useful when the content of a page updates frequently, for example displaying data from an API called dynamically with `fetch()`. | ||
|
|
||
| :::tip | ||
| On-demand server rendering in Astro, especially when combined with [view transitions](/en/guides/view-transitions/), provides a true app experience without the JavaScript overhead of a client-side, single-page application. Even highly dynamic, interactive apps are possible. |
There was a problem hiding this comment.
I am not sure if having both on-demand and server rendering should be the case. I guess we're doing this way so it's easier for people to say "oh, it's like SSR" -- but my feeling generally goes towards choosing one and keeping it to make things clear and straightforward, but sure it would make sense to mention at the start "On-demand rendering, similar to server-side rendering (SSR), yada yada yada"
There was a problem hiding this comment.
Yeah, as the most basic of content, I'm OK having this be a tiny bit more explicit/all-encompassing like this. I wouldn't do it often, but on the one page we're introducing our concepts, I think it's fine!
| ### Server-first | ||
|
|
||
| **Astro leverages [server-rendering](/en/basics/rendering-modes/) over client-side rendering in the browser as much as possible.** This is the same approach that traditional server-side frameworks -- PHP, WordPress, Laravel, Ruby on Rails, etc. -- have been using for decades. But you don't need to learn a second server-side language to unlock it. With Astro, everything is still just HTML, CSS, and JavaScript (or TypeScript, if you prefer). | ||
| **Astro leverages [server-rendering](/en/basics/rendering/) over client-side rendering in the browser as much as possible.** This is the same approach that traditional server-side frameworks -- PHP, WordPress, Laravel, Ruby on Rails, etc. -- have been using for decades. But you don't need to learn a second server-side language to unlock it. With Astro, everything is still just HTML, CSS, and JavaScript (or TypeScript, if you prefer). |
There was a problem hiding this comment.
I did change server-rendering to not have a hyphen on the other page, but looks like we've been using it for a while, so pointing out I am not sure if that's grammatically correct.
There was a problem hiding this comment.
Thank you! I will do a global search and check for this throughout!
Description (required)
This is the WIP branch for the documentation changes for Astro v5, soon to be in beta.
Documentation may be incomplete, but feel free to use the deploy preview if you are trying out an early release of Astro v5: https://5-0-0-beta.docs.astro.build/
To do before merging
/redirect added in 8b2b3ebeditLinkchange made in b3dea25.Searchcomponent override changed in ca7d812