withastro / docs

Astro documentation
https://docs.astro.build/
MIT License
1.34k stars 1.51k forks source link

Update View Transitions Docs #8904

Open OliverSpeir opened 4 months ago

OliverSpeir commented 4 months ago

πŸ“‹ Suggested page

https://docs.astro.build/en/guides/view-transitions/

πŸ“‹ General description or bullet points (if proposing new content)

Add "Removing <ViewTransitions/> Component section

Maybe add tracking of browser support, I personally will volunteer for keeping this updated

As of right now:

sarah11918 commented 4 months ago

Great call out to document removing the component!

As for updating statuses... is there a predictable static link for checking each browser's status? I would prefer if we didn't have to ourselves literally say "Browser X, level Y support" but could have one link that never needs updating that is e.g.[current adoption status of Browser X](link we don't have to update)

Or, if some other source we trust is updating statuses, I would be OK to link to even a non-official source that we find reliable and have faith will themselves be updating.

liruifengv commented 4 months ago

How about the View Transitions API Docs In MDN?

sarah11918 commented 4 months ago

That link looks amazing, exactly what I was thinking of! :raised_hands:

OliverSpeir commented 4 months ago

That link covers level 1 Astro needs level 2 to be able to replace the ViewTransitions component

martrapp commented 4 months ago

Granted, mdn is currently a bit in transition between level 1 and 2 for the documentation, but liruifengv's link is fine. The startViewTransition table shows level 1 support and the @viewTransition table shows level 2 support.

sarah11918 commented 4 months ago

@martrapp posted his page recently https://events-3bg.pages.dev/jotter/api/references/#w3c-drafts ... would this work? (lol, Martin just commented)

OliverSpeir commented 4 months ago

Also worth noting that we need to explain that transition persist won’t be supported by the browsers

sarah11918 commented 3 months ago

Great addition! Looking for someone to run with this and make an initial draft PR for docs!

sarah11918 commented 2 months ago

Just checking to see whether anyone is interested in picking this one up! We've got the link mentioned above for browser support, and a section on removing the component would be welcome!