Stable sessions docs

[ascorbic]

Description (required)

Adds docs for the stable sessions feature:

• removes the experimental flag page
• adds new sessions guide
• adds session to context API docs
• includes the docgen output from feat: stable sessions astro#13527
• adds info to adapter pages
• add info on Cloudflare KV to the CF deployment guide

Related issues & labels (optional)

• Closes #
• Suggested label:

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Name	Link
🔨 Latest commit	dd572e4
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/67f69cca0b16ac0008153ea0
😎 Deploy Preview	https://deploy-preview-11352--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
en/guides/integrations-guide/cloudflare.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/netlify.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/node.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/vercel.mdx	Source changed, localizations will be marked as outdated.
en/guides/sessions.mdx	Localization added, will be marked as complete.
en/reference/api-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/configuration-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/error-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/session-config-missing-error.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/session-config-without-flag-error.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/session-storage-init-error.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/session-storage-save-error.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/session-without-supported-adapter-output-error.mdx	Source changed, localizations will be marked as outdated.
en/reference/experimental-flags/sessions.mdx	Source removed, will stop being tracked.
es/reference/errors/session-config-missing-error.mdx	Localization changed, will be marked as complete.
es/reference/errors/session-config-without-flag-error.mdx	Localization changed, will be marked as complete.
es/reference/errors/session-storage-init-error.mdx	Localization changed, will be marked as complete.
es/reference/errors/session-storage-save-error.mdx	Localization changed, will be marked as complete.
fr/reference/configuration-reference.mdx	Localization changed, will be marked as complete.
fr/reference/errors/session-config-missing-error.mdx	Localization changed, will be marked as complete.
fr/reference/errors/session-config-without-flag-error.mdx	Localization changed, will be marked as complete.
fr/reference/errors/session-storage-init-error.mdx	Localization changed, will be marked as complete.
fr/reference/errors/session-storage-save-error.mdx	Localization changed, will be marked as complete.
fr/reference/experimental-flags/sessions.mdx	Localization removed, will be marked as missing.
ko/reference/configuration-reference.mdx	Localization changed, will be marked as complete.
ko/reference/errors/session-config-missing-error.mdx	Localization changed, will be marked as complete.
ko/reference/errors/session-config-without-flag-error.mdx	Localization changed, will be marked as complete.
ko/reference/errors/session-storage-init-error.mdx	Localization changed, will be marked as complete.
ko/reference/errors/session-storage-save-error.mdx	Localization changed, will be marked as complete.
ko/reference/experimental-flags/sessions.mdx	Localization removed, will be marked as missing.
pt-br/reference/errors/session-config-missing-error.mdx	Localization changed, will be marked as complete.
pt-br/reference/errors/session-config-without-flag-error.mdx	Localization changed, will be marked as complete.
pt-br/reference/errors/session-storage-init-error.mdx	Localization changed, will be marked as complete.
pt-br/reference/errors/session-storage-save-error.mdx	Localization changed, will be marked as complete.
zh-cn/reference/configuration-reference.mdx	Localization changed, will be marked as complete.
zh-cn/reference/errors/session-config-missing-error.mdx	Localization changed, will be marked as complete.
zh-cn/reference/errors/session-config-without-flag-error.mdx	Localization changed, will be marked as complete.
zh-cn/reference/errors/session-storage-init-error.mdx	Localization changed, will be marked as complete.
zh-cn/reference/errors/session-storage-save-error.mdx	Localization changed, will be marked as complete.
zh-cn/reference/experimental-flags/sessions.mdx	Localization removed, will be marked as missing.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[sarah11918]

Just a reminder that we can move the API docs to config reference in this PR for internal/link consistency, but changes will (also) have to be made in the astro repo to be pulled in here. Since this is the better authoring experience, it's fine to draft the docs here, and even keep them here, for the 5.7.0 branch!

We do just have to make sure that they are eventually added to the public config types, or else we'll lose them when that file overwrites the local configuration-reference file.

[ascorbic]

@sarah11918 to be clear, these config API changes have been authored in the Astro repo, but haven't been merged as they're part of the minor PR. I ran the docgen script so they also show up here. https://github.com/withastro/astro/pull/13527/files#diff-3919010fb2f9bfd24993b91e720147659af609f7f770c14a9aab6fb2908f5fe3R934

[sarah11918]

Just pushed a commit to remove the translations so that the slug check should now pass!

[sarah11918]

I believe checks should pass (or at least, shouldn't fail as a result of translations) now.

EDIT: nope! Still going...

[sarah11918]

Just submitting a partial review so far because GitHub is feeling particularly slow and unreliable! 😅

Pages still to review:

/guides/sessions.mdx
/reference/api-reference.mdx

[sarah11918]

Quick light editing suggestions on the api-reference page. Looks sooooo good! Great use of the tabs!

(Next up, and finally, just the sessions guide page to review)

[sarah11918]

OK @ascorbic - pushed a commit above for the API reference directly because I wanted to move headings around. (We don't need everything nexted under "basic usage" anymore because that's what this guide is now!)

At the same time, I made a few light text edits, because that's all this page needs. But, do feel free to push back on those! Was just easier with so little work needed while I was in the file anyway!

[sarah11918]

OK @ascorbic - I think there are only two unresolved issues here now: describing the sessions object and making sure everything is version 5.7.0

I resolved the config-reference nits because I did go check the implementation PR and I think that one looks fine. I'll check it when it's pulled in here to be sure everything worked out fine, but I think it's OK as far as content goes, and I left version comments there.

[sarah11918]

(Oh, and there are conflicts because the translators are translating under our feet... 😅 )

[sarah11918]

Noting that the Vercel additions look good! No notes! 💪

[yanthomasdev]

Good work, here's my first pass at it. Mostly nits and a few improvements on the translations.

[sarah11918]

I think that means this one is good to go, subject only to anything last minute we notice! 🎉 (And, the inevitable docgen...)

Amazing work with this Matt! Can't wait for this to be live!