Skip to content

Add experimental sessions docs#10378

Merged
sarah11918 merged 12 commits into
5.1.0from
experimental-sessions
Dec 19, 2024
Merged

Add experimental sessions docs#10378
sarah11918 merged 12 commits into
5.1.0from
experimental-sessions

Conversation

@ascorbic
Copy link
Copy Markdown
Contributor

Description (required)

Adds docs for the experimental Sessions feature

Related issues & labels (optional)

withastro/roadmap#1055

@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 16, 2024

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit 90e836b
🔍 Latest deploy log https://app.netlify.com/sites/astro-docs-2/deploys/6762d9faa509ae00089f6ee4
😎 Deploy Preview https://deploy-preview-10378--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

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
Copy link
Copy Markdown
Contributor

astrobot-houston commented Dec 16, 2024

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/reference/experimental-flags/sessions.mdx Localization added, will be marked as complete.
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.

@ascorbic ascorbic added the minor-release For the next minor release; in the milestone, "merge queue" = approved for merging on release day. label Dec 16, 2024
@sarah11918 sarah11918 added add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) labels Dec 16, 2024
@sarah11918 sarah11918 added this to the 5.1.0 milestone Dec 16, 2024
@sarah11918
Copy link
Copy Markdown
Member

Left an editing pass! Mostly breaking the dense config info up into bite-sized pieces.

Also discovered:

  • unstorage's docs aren't great at hinting at what people should use as a driver name in our config (I think I handled this OK)
  • unstorage's docs don't seem to reveal driver options well? (e.g. we show an example configuring a consistency option that is not mentioned on their site, so I don't know how people are going to know what's available to them). I have glossed over this, and am fine with this especially as a first experimental release. In general, I'm not thrilled that we are relying on some magical undocumented options and telling people to go look at them in a place where they're not, but I can't really do much about this.
  • the name unstorage appears to be lower-case, so this is intentional throughout.

Comment thread src/content/docs/en/reference/experimental-flags/sessions.mdx Outdated
@sarah11918
Copy link
Copy Markdown
Member

updating branch to trigger another Netlify deploy and hope it "just works" this time

@sarah11918 sarah11918 changed the base branch from main to 5.1.0 December 18, 2024 14:22
@sarah11918
Copy link
Copy Markdown
Member

Just waiting to see whether we need to update our references to getting driver names from unstorage, but otherwise, this will be good to go!

@sarah11918 sarah11918 mentioned this pull request Dec 18, 2024
Comment thread src/content/docs/en/reference/experimental-flags/sessions.mdx Outdated
Comment thread src/content/docs/en/reference/experimental-flags/sessions.mdx Outdated
@sarah11918 sarah11918 merged commit 3fcb9a5 into 5.1.0 Dec 19, 2024
@sarah11918 sarah11918 deleted the experimental-sessions branch December 19, 2024 12:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) minor-release For the next minor release; in the milestone, "merge queue" = approved for merging on release day.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants