Skip to content

docs(theme): embed new token documentation - #2606

Draft
spike-rabbit wants to merge 1 commit into
mainfrom
docs/theme/new-token-docs
Draft

docs(theme): embed new token documentation#2606
spike-rabbit wants to merge 1 commit into
mainfrom
docs/theme/new-token-docs

Conversation

@spike-rabbit

@spike-rabbit spike-rabbit commented Aug 24, 2026

Copy link
Copy Markdown
Member

@kfenner

kfenner commented Aug 24, 2026

Copy link
Copy Markdown
Member

@spike-rabbit I think we usually do not keep deprecated stuff in the docs? I think we should delete it and maybe link to v49 and say there you'll find the old tokens, WDYT?

Or does that confuse the AI? I thought it's maybe not great to have deprecated stuff in the docs. It's no the same as if you have a deprecated property as that is clearly marked as such but there is no such concept for SASS/CSS vars.

@spike-rabbit

Copy link
Copy Markdown
Member Author

I assume/hope those were heavily used before. So I think it would be nice keeping them.
Especially since scss does not have a deprecation mechanism. So the docs might be the helpful to communicate, that those are deprecated.

@kfenner

kfenner commented Aug 27, 2026

Copy link
Copy Markdown
Member

@panch1739 @hbxes @Killusions Do you think we should keep deprecated tokens in our documentation (marked as such in the chapter title)?

@kfenner kfenner added this to the 51.0.0 milestone Aug 27, 2026
@kfenner kfenner added the documentation Improvements or additions to documentation label Aug 27, 2026
@Killusions

Copy link
Copy Markdown
Member

@panch1739 @hbxes @Killusions Do you think we should keep deprecated tokens in our documentation (marked as such in the chapter title)?

For AI migration this would be great

@panch1739

Copy link
Copy Markdown
Member

@spike-rabbit thank you so much for this! Regarding deprecation, i would say that we should keep it for some time so people understand that there is an architectural change here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants