list must reads

src/content/docs/basics/api.mdx

@@ -12,9 +12,36 @@ I made a start with …
 
 While I add more pages, I'm also happy that I can offer some links to previous work on the `astro-vtbot` package[^1].
 
-* [References](https://events-3bg.pages.dev/jotter/api/references/) to the specs and interesting articles beyond
 * An [Overview](https://events-3bg.pages.dev/jotter/api/) and a [Details](https://events-3bg.pages.dev/jotter/api/details/) article on the API
 * An in depth [same-document example](https://events-3bg.pages.dev/jotter/api/example/)
 
 [^1]: https://www.npmjs.com/package/astro-vtbot
 
+## References
+
+> Copied over from [astro-vtbot](https://events-3bg.pages.dev/jotter/api/references/)
+
+### Explainers
+* The Level 1 View Transition API *Explainer* at W3C/WICG: [https://github.com/WICG/view-transitions/blob/main/explainer.md](https://github.com/WICG/view-transitions/blob/main/explainer.md)
+* The Level 2 View Transition API *Explainer* at W3C/WICG: [https://github.com/WICG/view-transitions/blob/main/cross-doc-explainer.md#pageconceal](https://github.com/WICG/view-transitions/blob/main/cross-doc-explainer.md#pageconceal)
+
+
+### W3C Drafts
+* Level 1: The W3C Candidate Recommendation Snapshot: *CSS View Transitions Module Level 1* [https://drafts.csswg.org/css-view-transitions-1/](https://drafts.csswg.org/css-view-transitions-1/)
+
+* Level 2: The Editor’s Draft: *CSS View Transitions Module Level 2* [https://drafts.csswg.org/css-view-transitions-2/](https://drafts.csswg.org/css-view-transitions-2/)
+
+### MDN
+* The Documentation of the View Transition API on MDN [https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API)
+
+### Must Reads
+
+Highly recommended introductions by examples and deep dives:
+
+* Jake Archibald's *Same-document view transitions for single-page applications* [https://developer.chrome.com/docs/web-platform/view-transitions/same-document](https://developer.chrome.com/docs/web-platform/view-transitions/same-document)
+
+* Bramus' *Cross-document view transitions for multi-page applications* [https://developer.chrome.com/docs/web-platform/view-transitions/cross-document](https://developer.chrome.com/docs/web-platform/view-transitions/cross-document)
+
+* Jake's eye-opening article on [how to handle aspect ratio](https://jakearchibald.com/2024/view-transitions-handling-aspect-ratio-changes/)
+
+* A collection of [same-page and cross-page examples](https://view-transitions.chrome.dev/) from Bramus.