Skip to content

Docs: Add a link from [svelte-transition](https://svelte.dev/docs/svelte-transition) to [svelte/transition](https://svelte.dev/docs/svelte/transition) page #15296

@PetrLaskevic

Description

@PetrLaskevic

Describe the problem

As a newcomer I was curious, how to add animations in svelte (animations which would work well with {#if blocks that is).
So I found the https://svelte.dev/docs/svelte/svelte-transition page. Looks auto-generated from source, with little context to what is is.
I was then quite confused how to actually use it, until I found the other page with a similar name, actually adding the context: https://svelte.dev/docs/svelte/transition

Describe the proposed solution

Could there be please a link from https://svelte.dev/docs/svelte/svelte-transition to https://svelte.dev/docs/svelte/transition, saying something along the lines of:
"For context, see: https://svelte.dev/docs/svelte/transition"

This would help newbies greatly.
Thanks!

Importance

would make my life easier

Activity

RohithPariki

RohithPariki commented on May 28, 2025

@RohithPariki

Hi, I’d like to work on this issue. Could you please assign it to me?”

realfakenerd

realfakenerd commented on Jul 9, 2025

@realfakenerd

That would be good. Not only for the transition page, but for other pages like mentioned here: #15371.

Hm... 🤔 i think the documentation is great, but could be better, more explanation and examples, i want to help Svelte, but i am kind of lost on where to start, and i think this could be a great start for me and @RohithPariki if he wants to join the task.

I think that a overview of the features, famous websites that use it, maybe why they choose svelte and Sveltekit.

Some more examples to help better than what already is in the documentation, maybe more practical examples, translations would be great too, i know English, but i would like to see the documentation in Portuguese.

fabhari

fabhari commented on Aug 17, 2025

@fabhari
Contributor

Hi seems the above issues is fixed and live .

could anyone please close this issues and Label a new issues for newcomers please.

@7nik , @dummdidumm , @Ocean-OS , @Rich-Harris , @markpsiano , @cmdecker95 , @paoloricciuti

Image
PetrLaskevic

PetrLaskevic commented on Aug 17, 2025

@PetrLaskevic
Author

@fabhari While there is a link in the middle of the page, I think it is rather hidden...
It still does not adress my original concern of stating visibly, on top of the page. that there is a proper documentation page https://svelte.dev/docs/svelte/transition

I believe, the first line of the page should be something like this.

"This is an API reference for module "svelte-transition" which uses a Svelte feature called transitions, which you can understand here."

Adding to that point, "crossfade" is not even the first item in the list of transitions implemented by the module, why is there a link at "crossfade" and not say the first option, blur?
Should you add a link explaining what is a transition to every function implemented by the module? Probably not, I think it is far better to mention at the top of the page, with the message I mentioned.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationgood first issueA small, encapsulated issue, ideal for a new contributor to Svelte to tackle.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Participants

      @dummdidumm@realfakenerd@fabhari@PetrLaskevic@RohithPariki

      Issue actions

        Docs: Add a link from [svelte-transition](https://svelte.dev/docs/svelte-transition) to [svelte/transition](https://svelte.dev/docs/svelte/transition) page · Issue #15296 · sveltejs/svelte